.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1990-1991, The Regents of the University of California.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH strtod 3 "17 مايو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
strtod, strtof, strtold \- تحويل سلسلة محارف ASCII إلى عدد فاصل عائم
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdlib.h>\fP
.P
\fBdouble strtod(const char *restrict \fP\fInptr\fP\fB,\fP
\fB              char **_Nullable restrict \fP\fIendptr\fP\fB);\fP
\fBfloat strtof(const char *restrict \fP\fInptr\fP\fB,\fP
\fB              char **_Nullable restrict \fP\fIendptr\fP\fB);\fP
\fBlong double strtold(const char *restrict \fP\fInptr\fP\fB,\fP
\fB              char **_Nullable restrict \fP\fIendptr\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBstrtof\fP(), \fBstrtold\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
.fi
.SH الوصف
الدوال \fBstrtod\fP() و \fBstrtof\fP() و \fBstrtold\fP() تحول الجزء الأولي من السلسلة
المشار إليها بواسطة \fInptr\fP إلى تمثيل \fIdouble\fP و \fIfloat\fP و \fIlong double\fP
على التوالي.
.P
الشكل المتوقع للجزء الأولي من السلسلة هو مسافة بيضاء بادئة اختيارية كما
يُعرفها \fBisspace\fP(3)، وعلامة جمع (\[aq]+\[aq]) أو طرح (\[aq]\-\[aq])
اختيارية، ثم إما (i) عدد عشري، أو (ii) عدد ست عشري، أو (iii) لانهاية، أو
(iv) NAN (ليس رقمًا).
.P
يتكون \fIالعدد العشري\fP من تسلسل غير فارغ من الأرقام العشرية قد يحتوي على حرف
الأساس (النقطة العشرية، تعتمد على الإعدادات المحلية، عادةً \[aq].\[aq])،
يتبعه اختياريًا أس عشري. يتكون الأس العشري من \[aq]E\[aq] أو \[aq]e\[aq]،
متبوعًا بعلامة جمع أو طرح اختيارية، متبوعًا بتسلسل غير فارغ من الأرقام
العشرية، ويشير إلى الضرب في قوة 10.
.P
يتكون \fIالعدد الست عشري\fP من "0x" أو "0X" متبوعًا بتسلسل غير فارغ من الأرقام
الست عشرية قد يحتوي على حرف الأساس، يتبعه اختياريًا أس ثنائي. يتكون الأس
الثنائي من \[aq]P\[aq] أو \[aq]p\[aq]، متبوعًا بعلامة جمع أو طرح اختيارية،
متبوعًا بتسلسل غير فارغ من الأرقام العشرية، ويشير إلى الضرب في قوة 2. يجب
وجود حرف الأساس أو الأس الثنائي على الأقل.
.P
\fIاللانهاية\fP هي إما "INF" أو "INFINITY"، بغض النظر عن حالة الأحرف.
.P
\fINAN\fP هي "NAN" (بغض النظر عن حالة الأحرف) متبوعة اختياريًا بسلسلة محارف،
\fI(n\-char\-sequence)\fP، حيث تحدد \fIn\-char\-sequence\fP بطريقة تعتمد على التنفيذ
نوع NAN (انظر الإصدارات).
.SH "قيمة الإرجاع"
ترجع هذه الدوال القيمة المحولة، إن وُجدت.
.P
إذا لم يكن \fIendptr\fP NULL، يُخزَّن مؤشر إلى الحرف بعد آخر حرف استُخدم في
التحويل في الموقع المشار إليه بواسطة \fIendptr\fP.
.P
إذا لم يُجرَ أي تحويل، يُرجع صفر و (ما لم يكن \fIendptr\fP فارغًا) تُخزَّن قيمة
\fInptr\fP في الموقع المشار إليه بواسطة \fIendptr\fP.
.P
إذا تسببت القيمة الصحيحة في فيضان، يُرجع موجب أو سالب \fBHUGE_VAL\fP أو
\fBHUGE_VALF\fP أو \fBHUGE_VALL\fP (وفقًا لنوع الإرجاع وإشارة القيمة)، ويُخزَّن
\fBERANGE\fP في \fIerrno\fP.
.P
إذا تسببت القيمة الصحيحة في تدفق سفلي، تُرجع قيمة بمقدار لا يتجاوز
\fBDBL_MIN\fP أو \fBFLT_MIN\fP أو \fBLDBL_MIN\fP ويُخزَّن \fBERANGE\fP في \fIerrno\fP.
.SH الأخطاء
.TP 
\fBERANGE\fP
حدث فيضان أو تدفق سفلي.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBstrtod\fP(),
\fBstrtof\fP(),
\fBstrtold\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
.TE
.SH الإصدارات
.\" From glibc 2.8's stdlib/strtod_l.c:
.\"     We expect it to be a number which is put in the
.\"     mantissa of the number.
.\" It looks as though at least FreeBSD (according to the manual) does
.\" something similar.
.\" C11 says: "An implementation may use the n-char sequence to determine
.\"	extra information to be represented in the NaN's significant."
في تنفيذ glibc، يُفسَّر \fIn\-char\-sequence\fP الذي يتبع "NAN" اختياريًا كعدد
صحيح (مع بادئة اختيارية '0' أو '0x' لاختيار الأساس 8 أو 16) ليُوضع في مكون
الجزء العشري من القيمة المرجعة.
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
.TP 
\fBstrtod\fP()
C89, POSIX.1\-2001.
.TP 
\fBstrtof\fP()
.TQ
\fBstrtold\fP()
C99، POSIX.1\-2001.
.SH تحذيرات
بما أن 0 يمكن إرجاعه شرعياً في كل من النجاح والفشل، يجب على البرنامج
المستدعي ضبط \fIerrno\fP إلى 0 قبل الاستدعاء، ثم تحديد ما إذا حدث خطأ بالتحقق
مما إذا كان \fIerrno\fP يحمل قيمة غير صفرية بعد الاستدعاء.
.SH أمثلة
انظر المثال في صفحة دليل \fBstrtol\fP(3)؛ استخدام الدوال الموصوفة في صفحة
الدليل هذه مشابه.
.SH "انظر أيضًا"
\fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBnan\fP(3), \fBnanf\fP(3), \fBnanl\fP(3),
\fBstrfromd\fP(3), \fBstrtol\fP(3), \fBstrtoul\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 .