errno.h

<errno.h> هو ملف رأس في المكتبة القياسية للغة البرمجة C. يُعرّف هذا الملف وحدات ماكرو للإبلاغ عن حالات الخطأ واسترجاعها باستخدام الرمزerrno(اختصارًا لـ "رقم الخطأ"). ^{[ 1 ]}

errnoيتصرف هذا المتغير كمتغير عدد صحيح. تقوم errnoبعض دوال المكتبة بتخزين قيمة (رقم الخطأ) فيه عند اكتشافها للأخطاء. عند بدء تشغيل البرنامج، تكون القيمة المخزنة صفرًا. لا تخزن دوال المكتبة إلا القيم الأكبر من الصفر. يمكن لأي دالة مكتبة تغيير القيمة المخزنة قبل الإرجاع، سواءً اكتشفت أخطاءً أم لا. ^{[ 2 ]} تشير معظم الدوال إلى اكتشافها خطأً بإرجاع قيمة خاصة، عادةً NULL للدوال التي تُرجع مؤشرات ، و -1 للدوال التي تُرجع أعدادًا صحيحة. تتطلب بعض الدوال من المُستدعي ضبط القيمة مسبقًا على الصفر ثم اختبارها لاحقًا لمعرفة ما إذا تم اكتشاف خطأ.errno

errnoيتوسع الماكرو إلى قيمة قابلة للتعديل من النوع int، وأحيانًا مع مُحدِّدات النوع externو/أو volatileاعتمادًا على النظام الأساسي. ^{[ 3 ]} في الأصل، كان هذا موقعًا ثابتًا في الذاكرة، ولكن تُستخدم الماكرو اليوم بشكل شبه دائم للسماح بتعدد الخيوط ، بحيث يرى كل خيط رقم خطأ محلي خاص به .

يُعرّف ملف الرأس أيضًا وحدات ماكرو تتوسع إلى ثوابت عددية صحيحة تُمثل رموز الخطأ. لا تتطلب مكتبة C القياسية سوى تعريف ثلاثة منها: ^{[ 2 ]}

تتضمن أنظمة التشغيل المتوافقة مع معيار POSIX، مثل AIX و Linux و Solaris ، العديد من قيم الأخطاء الأخرى، والتي يُستخدم الكثير منها بشكل أكثر شيوعًا من القيم المذكورة أعلاه، مثل EACCESالخطأ الذي يُشير إلى تعذر فتح ملف للقراءة. ^{[ 5 ]} كما يُعرّف معيار C++11 العديد من القيم نفسها الموجودة في مواصفات POSIX. ^{[ 6 ]}

تقليديًا، تسرد الصفحة الأولى من أدلة أنظمة يونكس ، المسماة intro(2)، جميع وحدات الماكرو errno.h، ولكن هذا ليس هو الحال مع لينكس ، حيث يتم سرد وحدات الماكرو هذه بدلاً من ذلك في errno(3). ^{[ 7 ]}

يمكن ترجمة `an` errnoإلى سلسلة وصفية باستخدام `strerror` (المُعرّفة في <string.h> ) أو امتداد BSD يُسمى `perror` . ويمكن طباعة الترجمة مباشرةً إلى دفق الخطأ القياسي باستخدام `perror` (المُعرّفة في <stdio.h> ). ولأن ` perror` غير آمنة للاستخدام في بيئات متعددة الخيوط في العديد من أنظمة يونكس، يتم استخدام نسخة آمنة للاستخدام في بيئات متعددة الخيوط، ولكن تعارض التعريفات بين POSIX وGNU يجعلها أقل قابلية للنقل من الجدول. ^{[ 8 ]}sys_errliststrerrorstrerror_rsys_errlist

توفر مكتبة GNU C (GLIBC) وحدات الماكرو الإضافية لقيم أخطاء POSIX في ملف الرأس <errno.h> . ^{[ 9 ]} هذه هي أوصاف وحدات الماكرو التي توفرها دالة strerror . ^{[ 10 ]}

تُعرَّف أسماء الماكرو ومعاني رموز الأخطاء في تعريف معايير POSIX، إلا أن القيم العددية غير مُعرَّفة، مع أن القيم تبدو متطابقة في مختلف إصدارات يونكس وفقًا للعرف. لذا، ينبغي ألا تعتمد البرامج على قيم عددية محددة، بل يجب اختبار الشيفرة باستخدام أسماء الماكرو المحددة في قسم الأخطاء (ERRORS) من صفحة الدليل ( man page) للدالة المعنية. ولضمان سهولة قراءة الشيفرة المصدرية وقابليتها للنقل، يُوصى بشدة باستخدام أسماء الماكرو القياسية في الشيفرة. ^{[ 12 ] [ 13 ]}

• خطأ
• ستروير

• ستيفنز، دبليو. ريتشارد؛ راغو، ستيفن أ. (24 مايو 2013). البرمجة المتقدمة في بيئة يونكس (  الطبعة الثالثة). أديسون-ويسلي بروفيشنال . ISBN 978-0321637734تم الاطلاع عليه بتاريخ 27 فبراير 2015 .

• intro(2) دليل استدعاءات نظام FreeBSD 
• errno(3) – دليل مبرمج لينكس – وظائف المكتبة من Manned.org 
• دليل مكتبة GNU C: رموز الخطأ
• قوائم قيم errno على نظام لينكس، سواء كانت رقمية أو رمزية