.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, David Metcalfe <david@prism.demon.co.uk>
.\" 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 atoi 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
atoi, atol, atoll \- تحويل سلسلة محارف إلى عدد صحيح
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdlib.h>\fP
.P
\fBint atoi(const char *\fP\fInptr\fP\fB);\fP
\fBlong atol(const char *\fP\fInptr\fP\fB);\fP
\fBlong long atoll(const char *\fP\fInptr\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBatoll\fP():
.nf
    _ISOC99_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH الوصف
الدالة \fBatoi\fP() تحول الجزء الأولي من السلسلة المشار إليها بواسطة \fInptr\fP
إلى \fIint\fP. السلوك مماثل لـ
.P
.in +4n
.EX
strtol(nptr, NULL, 10);
.EE
.in
.P
باستثناء أن \fBatoi\fP() لا تكتشف الأخطاء.
.P
تتصرف الدالتان \fBatol\fP() و \fBatoll\fP() بنفس طريقة \fBatoi\fP()، باستثناء أنهما
تحولان الجزء الأولي من السلسلة إلى نوع الإرجاع الخاص بهما \fIlong\fP أو
\fIlong\ long\fP.
.SH "قيمة الإرجاع"
القيمة المحولة أو 0 عند الخطأ.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBatoi\fP(),
\fBatol\fP(),
\fBatoll\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
.TE
.SH الإصدارات
يترك POSIX.1 قيمة الإرجاع لـ \fBatoi\fP() عند الخطأ غير محددة. في glibc و musl
libc و uClibc، يُعاد 0 عند الخطأ.
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
C99, POSIX.1\-2001, SVr4, 4.3BSD.
.P
.\" .SH NOTES
.\" Linux libc provided
.\" .BR atoq ()
.\" as an obsolete name for
.\" .BR atoll ();
.\" .BR atoq ()
.\" is not provided by glibc.
.\" The
.\" .BR atoll ()
.\" function is present since glibc 2.0.2, but
.\" not in libc4 or libc5.
يتضمن C89 و POSIX.1\-1996 الدالتين \fBatoi\fP() و \fBatol\fP() فقط.
.SH العلل
لا يُضبط \fIerrno\fP عند الخطأ، لذا لا توجد طريقة للتمييز بين 0 كخطأ وكقيمة
محولة. لا تُجرى فحوصات للفيضان أو النقصان. يمكن تحويل الإدخال ذي الأساس 10
فقط. يُوصى بدلاً من ذلك باستخدام عائلة الدوال \fBstrtol\fP() و \fBstrtoul\fP() في
البرامج الجديدة.
.SH "انظر أيضًا"
\fBatof\fP(3), \fBstrtod\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 .