exit

رموز الخروج الدلالية

الاستخدام

يذهب

 os . Exit ( exit . Forbidden ) // The user isn't permitted to perform this action
os . Exit ( exit . Unavailable ) // An API this program consumes isn't available 

الصدأ

 use semantic_exit :: { exit , Code } ;

exit ( Code :: Forbidden ) ;
exit ( Code :: Unavailable ) ; 

بيثون

 import exit

exit . Code . Forbidden . exit ()
exit . Code . Unavailable . exit ()

انظر القائمة الكاملة لرموز الخروج.

عن

بشكل تقليدي ، يشير الخروج من برنامج مع صفر إلى النجاح بينما يشير غير صفري إلى الفشل.

 os . Exit ( 0 ) // success
os . Exit ( 1 ) // failure

لكن exit استدعاء النظام يقبل القيم بين 0 و 255 ، تاركًا 254 طريقة مختلفة للتعبير عن الفشل.

أهداف هذه المكتبة هي تحديد رموز الخروج التي هي:

1. ينطبق على نطاق واسع على أدوات سطر الأوامر غير المتجانسة
2. من السهل التقسيم إلى أخطاء المستخدم وأخطاء النظام

إنه يحدد الرموز في نطاقات غير محفوظة: 80-99 لأخطاء المستخدم و 100-119 لأخطاء البرنامج أو النظام.

الرموز

رمز الخروج	اسم	معنى
0	OK	خرج البرنامج بنجاح.
1	NotOK	خرج البرنامج دون جدوى ولكن لا يعطي سياقًا إضافيًا فيما يتعلق بالفشل.
80	UsageError	خرج البرنامج دون جدوى لأنه تم استخدامه بشكل غير صحيح. (على سبيل المثال ، تم حذف وسيطة مطلوبة أو تم توفير قيمة غير صالحة للعلم.)
81	UnknownSubcommand	خرج البرنامج دون جدوى لأنه تم استدعاء مجموعة فرعية غير معترف بها. (تستخدمها CLI Multi Tools.)
82	RequirementNotMet	خرج البرنامج دون جدوى لأنه لم يتم الوفاء بشرط مسبق منه.
83	Forbidden	خرج البرنامج دون جدوى لأن المستخدم غير مصرح له بتنفيذ الإجراء المطلوب.
84	MovedPermanently	خرج البرنامج دون جدوى لأنه تم ترحيله إلى موقع جديد.
100	InternalError	خرج البرنامج دون جدوى بسبب مشكلة في الكود الخاص به. (تستخدم بدلاً من 1 عندما يكون المشكلة معروفة مع رمز البرنامج أو تبعياته.)
101	Unavailable	خرج البرنامج دون جدوى لأن الخدمة التي تعتمد عليها لم تكن متوفرة. (على سبيل المثال ، لم يستجب خفيون محلي أو خدمة عن بُعد ، تم إغلاق اتصال بشكل غير متوقع ، استجابت خدمة HTTP بـ 503.)

الرموز المحجوزة والفن السابق

• يتم حجز القيم فوق 128 للإشارات. (عندما يتم إنهاء برنامج بإشارة ، فإن رمز الخروج الخاص به هو 128 + القيمة الرقمية للإشارة. عند إنهاء برنامج باستخدام Ctrl C ، على سبيل المثال ، ترسلها إلى SIGINT الإشارة - والتي تكون قيمتها 2 - وتخرج البرنامج بـ 130.)
• باش احتياطيات 2 و 126 و 127.
• sysexits.h تعريف 64-78. تم تعريف رموز sysexits.h في الأصل لـ sendmail ولكن تم استخدامها في العديد من الأماكن منذ ذلك الحين. (قارن رموز الخروج الدلالية مع رموز sysexits.H)