.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1996, Andries E. Brouwer <aeb@cwi.nl>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH perror 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
perror \- طباعة رسالة خطأ نظام
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdio.h>\fP
.P
\fBvoid perror(const char *\fP\fIs\fP\fB);\fP
.P
\fB#include <errno.h>\fP
.P
\fBint \fP\fIerrno\fP\fB;  \fP\f[R]/* Not really declared this way; see errno(3) */\fR
.P
\fB[[deprecated]] const char *const \fP\fIsys_errlist\fP\fB[];\fP
\fB[[deprecated]] int \fP\fIsys_nerr\fP\fB;\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fIsys_errlist\fP, \fIsys_nerr\fP:
.nf
    من glibc 2.19 إلى glibc 2.31:
        _DEFAULT_SOURCE
    glibc 2.19 وما قبلها:
        _BSD_SOURCE
.fi
.SH الوصف
تُنتج الدالة \fBperror\fP() رسالة على الخطأ المعياري تصف آخر خطأ وُوجِه أثناء
استدعاء دالة نظام أو مكتبة.
.P
أولاً (إذا كان \fIs\fP ليس NULL و \fI*s\fP ليس بايت فارغ (\[aq]\[rs]0\[aq]))،
تُطبع سلسلة المحارف الوسيطة \fIs\fP، متبوعة بنقطتين وفراغ. ثم تُطبع رسالة خطأ
مطابقة للقيمة الحالية لـ \fIerrno\fP وسطر جديد.
.P
لتحقيق أقصى فائدة، يجب أن تتضمن سلسلة المحارف الوسيطة اسم الدالة التي تسببت
في الخطأ.
.P
يمكن استخدام قائمة الأخطاء العامة \fIsys_errlist\fP[]، التي يمكن فهرستها بواسطة
\fIerrno\fP، للحصول على رسالة الخطأ بدون السطر الجديد. أكبر رقم رسالة مُقدَّم
في الجدول هو \fIsys_nerr\fP\-1. كن حذرًا عند الوصول المباشر إلى هذه القائمة، لأن
قيم الأخطاء الجديدة قد لا تُضاف إلى \fIsys_errlist\fP[]. استخدام
\fIsys_errlist\fP[] أصبح مهملاً الآن؛ استخدم \fBstrerror\fP(3) بدلاً من ذلك.
.P
عند فشل استدعاء نظام، فإنه عادةً ما يُرجع \-1 ويُعيِّن المتغير \fIerrno\fP إلى
قيمة تصف ما حدث من خطأ. (يمكن العثور على هذه القيم في \fI<errno.h>\fP.)
تفعل العديد من دوال المكتبة الشيء نفسه. تخدم الدالة \fBperror\fP() في ترجمة رمز
الخطأ هذا إلى شكل قابل للقراءة البشرية. لاحظ أن \fIerrno\fP غير مُعرَّف بعد
استدعاء نظام ناجح أو استدعاء دالة مكتبة ناجح: قد يُغيِّر هذا الاستدعاء هذا
المتغير، حتى لو نجح، على سبيل المثال لأنه استخدم داخليًا دالة مكتبة أخرى
فشلت. وبالتالي، إذا لم يتبع استدعاء فاشل فورًا استدعاء لـ \fBperror\fP()، فيجب
حفظ قيمة \fIerrno\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBperror\fP()
T}	سلامة الخيوط	MT\-Safe race:stderr
.TE
.SH المعايير
.TP 
\fIerrno\fP
.TQ
\fBperror\fP()
C11, POSIX.1\-2008.
.TP 
\fIsys_nerr\fP
.TQ
\fIsys_errlist\fP
BSD.
.SH التاريخ
.TP 
\fIerrno\fP
.TQ
\fBperror\fP()
POSIX.1\-2001, C89, 4.3BSD.
.TP 
\fIsys_nerr\fP
.TQ
\fIsys_errlist\fP
أُزيل في glibc 2.32.
.SH "انظر أيضًا"
\fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBstrerror\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 .