.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2016, International Business Machines Corp.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH strfromd 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
strfromd, strfromf, strfroml \- تحويل قيمة فاصلة عائمة إلى سلسلة محارف
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdlib.h>\fP
.P
\fBint strfromd(\fPsize_t n;
\fB             char \fP\fIstr\fP\fB[restrict \fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP
\fB             const char *restrict \fP\fIformat\fP\fB, double \fP\fIfp\fP\fB);\fP
\fBint strfromf(\fPsize_t n;
\fB             char \fP\fIstr\fP\fB[restrict \fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP
\fB             const char *restrict \fP\fIformat\fP\fB, float \fP\fIfp\fP\fB);\fP
\fBint strfroml(\fPsize_t n;
\fB             char \fP\fIstr\fP\fB[restrict \fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP
\fB             const char *restrict \fP\fIformat\fP\fB, long double \fP\fIfp\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBstrfromd\fP()، \fBstrfromf\fP()، \fBstrfroml\fP():
.nf
    __STDC_WANT_IEC_60559_BFP_EXT__
.fi
.SH الوصف
تحوِّل هذه الدوال قيمة فاصلة عائمة، \fIfp\fP، إلى سلسلة محارف، \fIstr\fP، بسلسلة
\fIformat\fP قابلة للتهيئة.  يُخزَّن على الأكثر \fIn\fP من المحارف في \fIstr\fP.
.P
يُكتَب البايت الختامي الصفري ('\[rs]0') إذا وفقط إذا كان \fIn\fP كبيرًا كفاية،
وإلا قُطعت السلسلة المكتوبة عند \fIn\fP من المحارف.
.P
الدوال \fBstrfromd\fP() و \fBstrfromf\fP() و \fBstrfroml\fP() مكافئة لـ
.P
.in +4n
.EX
snprintf(str, n, format, fp);
.EE
.in
.P
باستثناء سلسلة \fIformat\fP.
.SS "تنسيق سلسلة التنسيق"
يجب أن تبدأ سلسلة \fIformat\fP بالحرف \[aq]%\[aq]. يتبع ذلك دقة اختيارية تبدأ
بحرف النقطة (.)، يليها عدد صحيح عشري اختياري. إذا لم يُحدَّد عدد صحيح بعد
حرف النقطة، تُستخدم دقة صفر. أخيرًا، يجب أن تحتوي سلسلة التنسيق على أحد
محددات التحويل \fBa\fP أو \fBA\fP أو \fBe\fP أو \fBE\fP أو \fBf\fP أو \fBF\fP أو \fBg\fP أو \fBG\fP.
.P
يُطبَّق محدد التحويل بناءً على نوع الفاصلة العائمة المشار إليه بلاحقة
الدالة. لذلك، على عكس \fBsnprintf\fP()، لا تحتوي سلسلة التنسيق على حرف معدِّل
للطول. انظر \fBsnprintf\fP(3) للحصول على وصف مفصل لمحددات التحويل هذه.
.P
يتوافق التنفيذ مع معيار C99 بشأن تحويل قيم NaN واللانهاية:
.P
.RS
إذا كان \fIfp\fP هو NaN أو +NaN أو \-NaN، وكان \fBf\fP (أو \fBa\fP أو \fBe\fP أو \fBg\fP) هو
محدد التحويل، فالتحويل يكون إلى "nan" أو "nan" أو "\-nan" على التوالي. إذا
كان \fBF\fP (أو \fBA\fP أو \fBE\fP أو \fBG\fP) هو محدد التحويل، فالتحويل يكون إلى "NAN"
أو "\-NAN".
.P
وبالمثل إذا كان \fIfp\fP لانهاية، يُحوَّل إلى [\-]inf أو [\-]INF.
.RE
.P
سلسلة \fIformat\fP مشوهة تؤدي إلى سلوك غير محدد.
.SH "قيمة الإرجاع"
تُرجع الدوال \fBstrfromd\fP() و \fBstrfromf\fP() و \fBstrfroml\fP() عدد المحارف التي
كان سيُكتَب في \fIstr\fP لو كان \fIn\fP لديه مساحة كافية، دون احتساب البايت
الختامي الصفري. وبالتالي، قيمة إرجاع تساوي \fIn\fP أو أكبر تعني أن المخرجات
قُطعت.
.SH السمات
لشرح المصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7) وقسم \fBPOSIX Safety Concepts\fP في دليل مكتبة GNU C.
.P
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBstrfromd\fP(),
\fBstrfromf\fP(),
\fBstrfroml\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
\^	أمان الإشارة غير المتزامنة	AS\-Unsafe heap
\^	أمان الإلغاء غير المتزامن	AC\-Unsafe mem
.TE
.P
ملاحظة: هذه السمات أولية.
.SH المعايير
ISO/IEC TS 18661\-1.
.SH الإصدارات
.TP 
\fBstrfromd\fP()
.TQ
\fBstrfromf\fP()
.TQ
\fBstrfroml\fP()
glibc 2.25.
.SH ملاحظات
تراعي هذه الدوال فئة \fBLC_NUMERIC\fP من الإعدادات المحلية الحالية.
.SH أمثلة
لتحويل القيمة 12.1 كنوع عائم إلى سلسلة محارف باستخدام الترميز العشري، مما
ينتج "12.100000":
.P
.in +4n
.EX
#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromf(s, ssize, "%f", 12.1);
.EE
.in
.P
لتحويل القيمة 12.3456 كنوع عائم إلى سلسلة محارف باستخدام الترميز العشري
برقمين من الدقة، مما ينتج "12.35":
.P
.in +4n
.EX
#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromf(s, ssize, "%.2f", 12.3456);
.EE
.in
.P
لتحويل القيمة 12.345e19 كنوع مزدوج إلى سلسلة محارف باستخدام الترميز العلمي
بدون أرقام دقة، مما ينتج "1E+20":
.P
.in +4n
.EX
#define __STDC_WANT_IEC_60559_BFP_EXT__
#include <stdlib.h>
int ssize = 10;
char s[ssize];
strfromd(s, ssize, "%.E", 12.345e19);
.EE
.in
.SH "انظر أيضًا"
\fBatof\fP(3), \fBsnprintf\fP(3), \fBstrtod\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .