الاسم¶

strfromd, strfromf, strfroml - تحويل قيمة فاصلة عائمة إلى سلسلة محارف

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#include <stdlib.h>

int strfromd(size_t n;
             char str[restrict n], size_t n,
             const char *restrict format, double fp);
int strfromf(size_t n;
             char str[restrict n], size_t n,
             const char *restrict format, float fp);
int strfroml(size_t n;
             char str[restrict n], size_t n,
             const char *restrict format, long double fp);

strfromd()، strfromf()، strfroml():

    __STDC_WANT_IEC_60559_BFP_EXT__

الوصف¶

تحوِّل هذه الدوال قيمة فاصلة عائمة، fp، إلى سلسلة محارف، str، بسلسلة format قابلة للتهيئة. يُخزَّن على الأكثر n من المحارف في str.

يُكتَب البايت الختامي الصفري ('\0') إذا وفقط إذا كان n كبيرًا كفاية، وإلا قُطعت السلسلة المكتوبة عند n من المحارف.

الدوال strfromd() و strfromf() و strfroml() مكافئة لـ

snprintf(str, n, format, fp);

باستثناء سلسلة format.

قيمة الإرجاع¶

تُرجع الدوال strfromd() و strfromf() و strfroml() عدد المحارف التي كان سيُكتَب في str لو كان n لديه مساحة كافية، دون احتساب البايت الختامي الصفري. وبالتالي، قيمة إرجاع تساوي n أو أكبر تعني أن المخرجات قُطعت.

السمات¶

لشرح المصطلحات المستخدمة في هذا القسم، انظر attributes(7) وقسم POSIX Safety Concepts في دليل مكتبة GNU C.

ملاحظة: هذه السمات أولية.

المعايير¶

ISO/IEC TS 18661-1.

الإصدارات¶

strfromd()

strfromf()

strfroml()

glibc 2.25.

ملاحظات¶

تراعي هذه الدوال فئة LC_NUMERIC من الإعدادات المحلية الحالية.

أمثلة¶

لتحويل القيمة 12.1 كنوع عائم إلى سلسلة محارف باستخدام الترميز العشري، مما ينتج "12.100000":

#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromf(s, ssize, "%f", 12.1);

لتحويل القيمة 12.3456 كنوع عائم إلى سلسلة محارف باستخدام الترميز العشري برقمين من الدقة، مما ينتج "12.35":

#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromf(s, ssize, "%.2f", 12.3456);

لتحويل القيمة 12.345e19 كنوع مزدوج إلى سلسلة محارف باستخدام الترميز العلمي بدون أرقام دقة، مما ينتج "1E+20":

#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromd(s, ssize, "%.E", 12.345e19);

انظر أيضًا¶

atof(3), snprintf(3), strtod(3)

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.