atoi(3)

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

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

موجز
#include <stdlib.h>

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

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

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).
الواجهة | السمة | القيمة
atoi(), atol(), atoll() | سلامة الخيوط | المنطقة (locale) آمنة لتعدد المسالك (MT-Safe)

الإصدارات
يترك 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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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