getopts

getoptsهو أمر مدمج في نظام يونكس لتحليل وسائط سطر الأوامر . وهو مصمم لمعالجة وسائط سطر الأوامر التي تتبع إرشادات بناء جملة أدوات POSIX، استنادًا إلى واجهة C الخاصة بـ getopt .

كان البرنامج السابق getoptsهو البرنامج الخارجي getoptالذي طورته مختبرات أنظمة يونكس .

كانت النسخة الأصلية getoptتعاني من عدة مشاكل: لم تكن قادرة على التعامل مع المسافات البيضاء أو الأحرف الخاصة بالصدفة في الوسائط، ولم تكن هناك إمكانية لتعطيل إخراج رسائل الخطأ. ^{[ 1 ]}

getoptsتم تقديم الأمر getopts لأول مرة عام 1986 في بيئة Bourne shell المرفقة مع نظام Unix SVR3. يستخدم هذا الأمر متغيرات البيئة نفسها لتتبع موضع الخيار الحالي وموضع الوسيط، وهما OPTIND و OPTARG ، ويعيد اسم الخيار في متغير خاص بالبيئة. ^{[ 2 ]} لم تكن الإصدارات السابقة من Bourne shell تحتوي على الأمر getopts .

في عام 1995، getoptsتم تضمينها في الإصدار 1 من مواصفات يونكس الموحدة / إرشادات قابلية النقل X/Open الإصدار 4. ^{[ 3 ]} ونتيجة لذلك، getoptsأصبحت متاحة الآن في صدفات الأوامر بما في ذلك صدفة بورن ، وصدفة كورن ، وصدفة ألمكويست ، وباش ، وزد إس إتش . ^{[ 4 ]}

تم أيضًا نقل أمر getopts إلى نظام التشغيل IBM i . ^{[ 5 ]}

أُعيد إحياء الاستخدام الحديث getoptجزئيًا بفضل تحسينات في تطبيق util-linux . لم يقتصر هذا الإصدار، المبني على نظام BSD getopt، على معالجة المشكلتين المتعلقتين بالإصدار القديم getopt، بل أضاف أيضًا إمكانية تحليل الخيارات الطويلة بنمط GNU والوسائط الاختيارية للخيارات، وهي ميزات كانت getoptsتفتقر إليها النسخة القديمة. ^{[ 6 ]} مع ذلك، التزمت توزيعات BSD المختلفة بالتنفيذ القديم. ^{[ 1 ]}

إن ملخص استخدام getopt و getopts مشابه لنظيره في لغة C :

getopt optstring [parameters] getopts optstring varname [parameters]

• يحتوي جزء optstring على نفس تنسيق الجزء الشقيق C.
• يقبل قسم المعاملات ببساطة أي شيء يرغب المستخدم في أن يقوم getopt بتحليله. القيمة الشائعة هي جميع المعاملات، "$@" في نظام POSIX shell.
  • توجد هذه القيمة في دالة getopts، ولكن نادرًا ما تُستخدم، لأنها لا تستطيع سوى الوصول إلى معلمات الصدفة. مع ذلك، فهي مفيدة في إعادة ضبط المحلل اللغوي.
• يشير الجزء varname من getopts إلى متغير shell لتخزين الخيار الذي تم تحليله.

لكن طريقة استخدام الأوامر تختلف كثيراً:

• تقوم الدالة getopt ببساطة بإرجاع سلسلة نصية مسطحة تحتوي على رموز مفصولة بمسافات بيضاء تمثل الوسيط "المُعَيَّر". ثم يتم استخدام حلقة while لتحليلها بشكل أصلي. ^{[ 1 ]}
• يُفترض استدعاء دالة getopts بشكل متكرر مثل دالة getopt في لغة C. وعندما تصل إلى نهاية الوسائط، تُرجع القيمة 1 (خطأ في سطر الأوامر). ^{[ 3 ]}

لنفترض أننا نقوم ببناء برنامج تنزيل من ويكيبيديا باستخدام لغة باش، ويأخذ ثلاثة خيارات ولا يأخذ أي وسائط إضافية:

wpdown -a اسم المقالة -l [اللغة] -v

عند الإمكان، نسمح بالحجج الطويلة التالية:

-a --article -l --language, --lang -v --verbose

للتوضيح، لم يتم تضمين أي نص مساعدة، ونفترض وجود برنامج يقوم بتنزيل أي صفحة ويب. بالإضافة إلى ذلك، جميع البرامج تأتي على الشكل التالي:

#!/bin/bash Verbose = 0 Article = lang = en # [مثال هنا]إذا كان مستوى الإسهاب ( verbose ) أكبر من 2 ، فسيتم طباعة سطر جديد يحتوي على الوسائط غير الاختيارية ، ثم طباعة سطر جديد يحتوي على الوسائط المتبقية .إذا كان مستوى الإسهاب ( verbose ) أكبر من 1 ، فسيتم طباعة الرسالة التالية : "جارٍ تنزيل %s:%s\n" " $lang " " $article " fiإذا لم تكن هناك مقالات ، فسيتم طباعة رسالة "لا توجد مقالات!" متبوعة برقم 2، ثم يتم إنهاء البرنامج برمز خطأ 1 . save_webpage "https:// ${ lang } .wikipedia.org/wiki/ ${ article } "

# تحليل كل شيء؛ إذا فشل، نتوقف args = ` getopt 'a:l:v' $* ` || exit # الآن لدينا الوسائط المُعقَّمة... استبدل الوسائط الأصلية بها set -- $argsبينما صحيح ؛ نفّذ الحالة $1 في ( -v ) (( verbose++ )) ؛ إزاحة ؛؛ ( -a ) مقالة = $2 ؛ إزاحة 2 ؛؛ ( -l ) لغة = $2 ؛ إزاحة 2 ؛؛ ( -- ) إزاحة ؛ استراحة ؛؛ ( * ) خروج 1 ؛؛ # خطأ esac تمالمتبقي = ( " $@ " )

#!/bin/sh while getopts ':a:l:v' opt ; do case $opt in ( v ) (( verbose++ )) ;; ( a ) article = $OPTARG ;; ( l ) lang = $OPTARG ;; ( : ) # "وسائط اختيارية" (معالجة الوسائط الاختيارية مفقودة) case $OPTARG in ( a ) exit 1 ;; # خطأ، وفقًا لصيغتنا ( l ) : ;; # مقبول ولكنه لا يفعل شيئًا esac ;; esac doneshift " $(( OPTIND - 1 )) " # المتبقي هو "$@"

#!/bin/bash# نستخدم "${@}" بدلاً من "${*}" للحفاظ على معلومات حدود الوسائط args = $( getopt --options 'a:l::v' --longoptions 'article:,lang::,language::,verbose' -- " ${ @ } " ) || exit eval "set -- ${ args } "بينما صحيح ؛ نفّذ الحالة " ${1} " في ( -v | --verbose ) ( ( verbose++ ) ) إزاحة ؛؛ ( -a | --article ) article = $ {2} إزاحة 2 ؛؛ ( -l | --lang | --language ) # التعامل مع الاختياري: getopt يُحوّله إلى سلسلة فارغة إذا [[ -n $ {2} ] ] ؛ ثم lang = $ {2} fi إزاحة 2 ؛؛ ( -- ) إزاحة فاصل ؛؛ ( * ) خروج 1 # خطأ ؛؛ esac انتهىremaining_args =( " ${ @ } " )

• قائمة أوامر يونكس

• getoptsمعالجة وسائط سطر الأوامر – مرجع الصدفة والأدوات المساعدة، مواصفات يونكس الموحدة ، الإصدار 5 من مجموعة Open Group