getoptsposix - عبر الإنترنت في السحابة

برنامج:

اسم

getopts — تحليل خيارات الأداة المساعدة

موجز

com.getopts com.optstring الاسم [الأرجنتين ]

الوصف

• com.getopts يجب على الأداة المساعدة استرداد الخيارات ووسائط الخيارات من قائمة المعلمات.
يجب أن يدعم إرشادات بناء جملة المنفعة من 3 إلى 10، شاملة، الموضحة في القاعدة
حجم التعاريف من POSIX.1-2008 ، القسم 12.2, مرافق بناء الجملة التوجيهات.

في كل مرة يتم استدعاءها، com.getopts يجب أن تضع الأداة المساعدة قيمة الخيار التالي في
متغير الصدفة المحدد بواسطة الاسم المعامل وفهرس الوسيطة التالية
معالجتها في متغير شل اختر. كلما تم استدعاء الصدفة، اختر يجب أن تكون
مهيأ إلى 1.

عندما يتطلب الخيار وسيطة خيار، فإن com.getopts يجب أن تضعه الأداة المساعدة في
متغير شل أوبتارج. إذا لم يتم العثور على خيار، أو إذا لم يتم العثور على الخيار الذي تم العثور عليه
لديك حجة الخيار، أوبتارج يجب أن تكون غير محددة.

إذا كان حرف الخيار غير موجود في com.optstring تم العثور على المعامل حيث خيار
من المتوقع أن يكون الحرف هو متغير الصدفة المحدد بواسطة الاسم سيتم تعيينها على
علامة > ("؟") شخصية. في هذه الحالة، إذا كان الحرف الأول في com.optstring هو
(":")، متغير الصدفة أوبتارج يجب تعيين حرف الخيار الذي تم العثور عليه، ولكن لا يوجد إخراج
يجب أن تكون مكتوبة إلى الخطأ المعياري؛ وبخلاف ذلك، متغير الصدفة أوبتارج يجب أن تكون غير محددة
ويجب كتابة رسالة تشخيصية للخطأ القياسي. يكون هذا الشرط
يعتبر خطأ تم اكتشافه في طريقة تقديم الوسائط إلى الاستدعاء
التطبيق، ولكن لا يجوز أن يكون خطأ في com.getopts معالجة.

إذا كانت وسيطة الخيار مفقودة:

* إذا كان الحرف الأول من com.optstring هو ، متغير الصدفة المحدد بواسطة الاسم
سيتم تعيينها على الحرف ومتغير الصدفة أوبتارج يجب تعيين ل
تم العثور على حرف الخيار.

* بخلاف ذلك، يتم تحديد متغير الصدفة بواسطة الاسم سيتم تعيينها على
الحرف، متغير الصدفة أوبتارج يجب أن يتم إلغاء الضبط، ويجب أن تكون هناك رسالة تشخيصية
مكتوب لخطأ قياسي. تعتبر هذه الحالة بمثابة خطأ تم اكتشافه
بالطريقة التي تم بها تقديم الحجج لطلب الاستدعاء، ولكن لا يجوز أن تكون
خطأ في com.getopts يعالج؛ يجب كتابة رسالة تشخيصية كما هو مذكور، ولكن
يجب أن تكون حالة الخروج صفر.

عند مواجهة نهاية الخيارات، فإن com.getopts يجب الخروج من الأداة المساعدة بقيمة الإرجاع
أكبر من الصفر؛ متغير القشرة اختر يجب تعيينه على الفهرس الأول
المعامل، أو القيمة "$ #"+1 إذا لم تكن هناك معاملات؛ ال الاسم يجب تعيين المتغير على
ال شخصية. يجب أن يحدد أي مما يلي نهاية الخيارات: ال
أول "−−" حجة ليست حجة خيارية، العثور على حجة ليست حجة
وسيطة الخيار ولا تبدأ بـ "-"، أو مواجهة خطأ.

متغيرات القشرة اختر و أوبتارج يجب أن تكون محلية للمتصل com.getopts ويجب
لا يتم تصديرها بشكل افتراضي.

متغير الصدفة المحدد بواسطة الاسم معامل اخترو أوبتارج سوف تؤثر على
بيئة تنفيذ الصدفة الحالية؛ يرى القسم 2.12, قذيفة التنفيذ البيئة.

إذا تم تعيين التطبيق اختر إلى القيمة 1، يمكن استخدام مجموعة جديدة من المعلمات: إما
المعلمات الموضعية الحالية أو الجديدة الأرجنتين قيم. أي محاولة أخرى للاستدعاء com.getopts
عدة مرات في بيئة تنفيذ قذيفة واحدة مع المعلمات (الموضعية
المعلمات أو الأرجنتين المعاملات) التي ليست هي نفسها في جميع الدعوات، أو مع اختر
القيمة المعدلة لتكون قيمة أخرى غير 1، تؤدي إلى نتائج غير محددة.

OPTIONS

لا شيء.

العمليات

يجب دعم المعاملات التالية:

com.optstring سلسلة تحتوي على أحرف الخيارات التي تم التعرف عليها بواسطة استدعاء الأداة المساعدة
com.getopts. إذا كان الحرف متبوعًا بـ a ، يجب أن يكون الخيار متوقعا
للحصول على وسيطة، والتي ينبغي توفيرها كوسيطة منفصلة.
يجب أن تحدد التطبيقات حرف الخيار ووسيطة الخيار الخاصة به
حجج منفصلة، ​​ولكن com.getopts يجب تفسير الأحرف التالية ل
يتطلب حرف الخيار الوسائط كوسيطة سواء تم ذلك أم لا.
لا يلزم التعرف على وسيطة الخيار الفارغة الصريحة إذا لم يتم توفيرها كـ
حجة منفصلة عندما com.getopts يتم استدعاؤه. (أنظر أيضاً جيتوبت() وظيفة
المحددة في مجلد واجهات النظام لـ POSIX.1‐2008.) الأحرف
و لا يجوز استخدامها كأحرف خيار بواسطة
طلب. استخدام أحرف الخيارات الأخرى التي ليست أبجدية رقمية
يؤدي إلى نتائج غير محددة. إذا لم يتم توفير وسيطة الخيار كـ a
وسيطة منفصلة عن حرف الخيار، القيمة الموجودة أوبتارج يجب أن تكون
جردت من حرف الخيار و "-". الحرف الأول في com.optstring
يحدد كيف com.getopts يتصرف إذا كان حرف الخيار غير معروف أو خيار-
الحجة مفقودة.

الاسم اسم متغير الصدفة الذي يجب تعيينه بواسطة com.getopts فائدة ل
حرف الخيار الذي تم العثور عليه.

• com.getopts يجب على الأداة المساعدة بشكل افتراضي تحليل المعلمات الموضعية التي تم تمريرها إلى الاستدعاء
إجراء القشرة. لو الأرجنتينمعطاة، يجب أن يتم تحليلها بدلا من الموضعية
المعلمات.

ستدين

غير مستعمل.

INPUT FILES

لا شيء.

البيئة المتغيرات

يجب أن تؤثر متغيرات البيئة التالية على تنفيذ com.getopts:

لانج قم بتوفير قيمة افتراضية لمتغيرات التدويل غير المضبوطة أو
باطل. (انظر حجم التعريفات الأساسية لـ POSIX.1-2008 ، القسم 8.2,
التجارة في الخارج المتغيرات لأسبقية التدويل
المتغيرات المستخدمة لتحديد قيم الفئات المحلية.)

LC_ALL إذا تم التعيين على قيمة سلسلة غير فارغة ، فتجاوز قيم جميع القيم الأخرى
متغيرات التدويل.

LC_CTYPE تحديد الإعدادات المحلية لتفسير تسلسل بايت من البيانات النصية
كأحرف (على سبيل المثال ، أحادية البايت بدلاً من أحرف متعددة البايت بتنسيق
الحجج وملفات الإدخال).

رسائل LC
حدد الإعدادات المحلية التي يجب استخدامها للتأثير على تنسيق ومحتويات
رسائل التشخيص المكتوبة على خطأ قياسي.

نلسباث تحديد موقع كتالوجات الرسائل لمعالجتها رسائل LC.

اختر يجب استخدام هذا المتغير بواسطة com.getopts فائدة كمؤشر للتالي
الوسيطة المراد معالجتها.

غير متزامن فعاليات

افتراضي.

STDOUT

غير مستعمل.

ستدير

كلما تم اكتشاف خطأ والحرف الأول في com.optstring المعامل ليس أ
(":")، يجب كتابة رسالة تشخيصية للخطأ القياسي بما يلي
المعلومات بصيغة غير محددة:

* يجب تحديد اسم برنامج الاستدعاء في الرسالة. برنامج الاستدعاء
الاسم يجب أن يكون قيمة معلمة الصدفة الخاصة 0 (انظر القسم 2.5.2, ملصقات خاصة
المعلمات) في ذلك الوقت com.getopts يتم استدعاء الأداة المساعدة. اسم يعادل:

basename "$ 0"

يمكن استخدامها.

* إذا تم العثور على خيار لم يتم تحديده في com.optstring، تم تحديد هذا الخطأ
ويجب تحديد حرف الخيار غير الصالح في الرسالة.

* إذا تم العثور على خيار يتطلب وسيطة خيار، ولكن لم يتم العثور على وسيطة الخيار
تم العثور عليه، يجب تحديد هذا الخطأ ويجب أن يكون حرف الخيار غير صالح
المحددة في الرسالة.

OUTPUT FILES

لا شيء.

وسعوا الوصف

لا شيء.

EXIT الوضع

يتم إرجاع قيم الخروج التالية:

0 خيار محدد أو غير محدد بواسطة com.optstring، وجد.

>0 تمت مواجهة نهاية الخيارات أو حدث خطأ.

عواقب OF أخطاء

افتراضي.

• متابعيك أقسام . غنيا بالمعلومات.

تطبيق الاستعمال

منذ com.getopts يؤثر على بيئة تنفيذ الصدفة الحالية، ويتم توفيره بشكل عام كـ
قذيفة عادية مدمجة. إذا تم استدعاؤه في تنفيذ أداة فرعية أو منفصلة
البيئة ، مثل أحد ما يلي:

(جيتوبتس اي بي سي قيمنا "$@")
nohup com.getopts
جد . - تنفيذي com.getopts \;

ولا يؤثر على متغيرات الصدفة في بيئة المتصل.

لاحظ أن وظائف الصدفة تشترك اختر مع قذيفة الاستدعاء على الرغم من الموضعية
يتم تغيير المعلمات. إذا تم استخدام قذيفة الاستدعاء وأي من وظائفها com.getopts إلى
تحليل الوسائط، والنتائج غير محددة.

أمثلة

يقوم المثال النصي التالي بتوزيع وعرض الوسائط الخاصة به:

الأعلام =
بعلم=
في حين com.getopts أب: الاسم
do
حقيبة $ اسم in
a) العلم=1;;
b) بعلم=1
bval="$OPTARG";;
?) printf "الاستخدام: ٪س: [-أ] [-ب قيمة] الوسائط\n" $0
خروج 2؛؛
ESAC
فعل
if [ ! -ض "$العلم" ]; then
printf "خيار − أ محدد\n"
fi
if [ ! -ض "$بعلم" ]; then
printf 'خيار − ب "٪س" محدد\n' "$بفال"
fi
نقل $(($OPTIND - 1))
printf "متبقي الحجج هي: %s\n$*"

الأساس المنطقي

• com.getopts تم اختيار الأداة المساعدة بدلاً من System V جيتوبت فائدة لأن
com.getopts يعالج وسيطات الخيار التي تحتوي على الشخصيات.

• أوبتارج لم يتم ذكر المتغير في قسم متغيرات البيئة لأنه تم ذكره
لا يؤثر على تنفيذ com.getopts; إنه أحد متغيرات الإخراج فقط المستخدمة
بواسطة المرافق القياسية.

ال غير مسموح به كشخصية خيارية لأن هذا ليس سلوكًا تاريخيًا،
وينتهك إرشادات بناء جملة الأداة المساعدة. ال تم تحديده الآن ليكون بمثابة
في إصدار KornShell من com.getopts جدوى؛ عند استخدامه كحرف أول في
com.optstring المعامل، فإنه يعطل التشخيص المتعلق بوسائط الخيارات المفقودة و
أحرف خيار غير متوقعة. وهذا يحل محل استخدام أوبتر المتغير الذي كان
المحددة في الاقتراح المبكر.

تنسيقات الرسائل التشخيصية التي ينتجها com.getopts فائدة و جيتوبت()
لم يتم تحديد الوظيفة بشكل كامل لأن عمليات التنفيذ ذات الأداء المتميز ("الأكثر ودية")
اعترضت التنسيقات على التنسيقات المستخدمة من قبل بعض التطبيقات التاريخية. المعيار
واعتبر المطورون أنه من المهم أن تكون المعلومات الواردة في الرسائل المستخدمة موحدة
ما بين com.getopts و جيتوبت(). قد لا يكون النسخ الدقيق للرسائل ممكنًا،
خاصة إذا كانت الأداة المساعدة مبنية على نظام آخر له نظام مختلف جيتوبت()
وظيفة، ولكن يجب أن تتضمن الرسائل معلومات محددة حتى يتمكن البرنامج
يمكن للمستخدم تمييز الاسم وحرف الخيار غير الصالح ونوع الخطأ.

فقط برنامج تطبيق نادر يعترض أ com.getopts رسالة خطأ قياسية ويريد
تحليلها. لذلك، تتمتع التطبيقات بالحرية في اختيار الرسائل الأكثر قابلية للاستخدام
ابتكر. يتم استخدام التنسيقات التالية في العديد من التطبيقات التاريخية:

"٪س: غير شرعي خيار -− %c\n"، <برنامج الاسم>, <خيار حرف>

"%s: الخيار يتطلب وسيطة −− %c\n"،برنامج الاسم>، \
<خيار حرف>

الأصداف التاريخية مع الإصدارات المضمنة من جيتوبت() أو com.getopts لقد استخدمت مختلفة
التنسيقات، وفي كثير من الأحيان لا يشير حتى إلى حرف الخيار الذي تم العثور عليه عن طريق الخطأ.

المستقبل اتجاهات

لا شيء.

استخدم getoptsposix عبر الإنترنت باستخدام خدمات onworks.net