الاسم¶

atoi, atol, atoll - تحويل سلسلة محارف إلى عدد صحيح

المكتبة¶

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

موجز¶

#include <stdlib.h>

int atoi(const char *nptr);
long atol(const char *nptr);
long long atoll(const char *nptr);

atoll():

    _ISOC99_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف¶

الدالة atoi() تحول الجزء الأولي من السلسلة المشار إليها بواسطة nptr إلى int. السلوك مماثل لـ

strtol(nptr, NULL, 10);

باستثناء أن atoi() لا تكتشف الأخطاء.

تتصرف الدالتان atol() و atoll() بنفس طريقة atoi()، باستثناء أنهما تحولان الجزء الأولي من السلسلة إلى نوع الإرجاع الخاص بهما long أو long long.

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

القيمة المحولة أو 0 عند الخطأ.

السمات¶

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

الإصدارات¶

يترك POSIX.1 قيمة الإرجاع لـ atoi() عند الخطأ غير محددة. في glibc و musl libc و uClibc، يُعاد 0 عند الخطأ.

المعايير¶

C11, POSIX.1-2008.

التاريخ¶

C99, POSIX.1-2001, SVr4, 4.3BSD.

يتضمن C89 و POSIX.1-1996 الدالتين atoi() و atol() فقط.

العلل¶

لا يُضبط errno عند الخطأ، لذا لا توجد طريقة للتمييز بين 0 كخطأ وكقيمة محولة. لا تُجرى فحوصات للفيضان أو النقصان. يمكن تحويل الإدخال ذي الأساس 10 فقط. يُوصى بدلاً من ذلك باستخدام عائلة الدوال strtol() و strtoul() في البرامج الجديدة.

انظر أيضًا¶

atof(3), strtod(3), strtol(3), strtoul(3)

ترجمة¶

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

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

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