getoptsposix - آنلاین در ابر

برنامه:

نام

getopts - گزینه‌های کاربردی را تجزیه کنید

خلاصه

گرفتن optstring نام [ارگ...]

شرح

La گرفتن ابزار باید گزینه ها و آرگومان های گزینه را از لیستی از پارامترها بازیابی کند.
باید از دستورالعمل های نحوی سودمند 3 تا 10، شامل، که در پایه توضیح داده شده است، پشتیبانی کند.
حجم تعاریف POSIX.1-2008، بخش 12.2, سودمندی نحو دستورالعمل.

هر بار که فراخوانی می شود، گرفتن ابزار باید مقدار گزینه بعدی را در آن قرار دهد
متغیر پوسته مشخص شده توسط نام عملوند و شاخص آرگومان بعدی که باید باشد
در متغیر پوسته پردازش می شود OPTIND. هر زمان که پوسته فراخوانی می شود، OPTIND باید باشد
به 1 مقداردهی اولیه شد.

هنگامی که گزینه به یک آرگومان گزینه نیاز دارد، گرفتن ابزار باید آن را در
متغیر پوسته OPTARG. اگر گزینه ای پیدا نشد یا گزینه ای که پیدا شد پیدا نشد
یک گزینه-استدلال داشته باشید، OPTARG تنظیم نخواهد شد

اگر یک کاراکتر گزینه موجود در optstring عملوند در جایی یافت می شود که یک گزینه
شخصیت مورد انتظار است، متغیر پوسته مشخص شده توسط نام باید تنظیم شود
علامت> ("؟") شخصیت. در این صورت، اگر اولین کاراکتر در optstring هست یک
(':')، متغیر پوسته OPTARG باید روی کاراکتر گزینه یافت شده تنظیم شود، اما خروجی وجود ندارد
باید با خطای استاندارد نوشته شود. در غیر این صورت، متغیر پوسته OPTARG تنظیم نخواهد شد
و یک پیام تشخیصی باید با خطای استاندارد نوشته شود. این شرط باید باشد
در نظر گرفته می شود که خطایی در نحوه ارائه آرگومان ها به فراخوان شناسایی شده است
برنامه، اما نباید خطا باشد گرفتن در حال پردازش.

اگر یک آرگومان گزینه وجود نداشته باشد:

* اگر شخصیت اول از optstring هست یک ، متغیر پوسته مشخص شده توسط نام
باید تنظیم شود کاراکتر و متغیر پوسته OPTARG تنظیم خواهد شد
کاراکتر گزینه پیدا شد

* در غیر این صورت، متغیر پوسته مشخص شده توسط نام باید تنظیم شود
شخصیت، متغیر پوسته OPTARG باید تنظیم نشده باشد و یک پیام تشخیصی باید باشد
با خطای استاندارد نوشته شده است. این شرایط باید به عنوان خطای شناسایی شده در نظر گرفته شود
به روشی که استدلال‌ها به درخواست استناد ارائه شده‌اند، اما نباید باشد
خطا در گرفتن در حال پردازش؛ یک پیام تشخیصی باید همانطور که گفته شد نوشته شود، اما
وضعیت خروج باید صفر باشد.

هنگامی که پایان گزینه ها مواجه می شوند، گرفتن ابزار باید با یک مقدار بازگشتی خارج شود
بزرگتر از صفر؛ متغیر پوسته OPTIND باید به شاخص اول تنظیم شود
عملوند یا مقدار "$#"1+ اگر عملوندی وجود ندارد. را نام متغیر باید تنظیم شود
را شخصیت. هر یک از موارد زیر باید پایان گزینه ها را مشخص کند:
اول "--" آرگومانی که یک آرگومان گزینه نیست، یافتن آرگومانی که یک آرگومان نیست
option-argument و با a شروع نمی شود '-'، یا با خطا مواجه می شوید.

متغیرهای پوسته OPTIND و OPTARG باید محلی برای تماس گیرنده باشد گرفتن و باید
به طور پیش فرض صادر نمی شود.

متغیر پوسته مشخص شده توسط نام عملوند، OPTINDو OPTARG را تحت تاثیر قرار خواهد داد
محیط اجرای پوسته فعلی؛ دیدن بخش 2.12, صدف اعدام محیط.

اگر برنامه تنظیم شود OPTIND برای مقدار 1، مجموعه جدیدی از پارامترها را می توان استفاده کرد: یا
پارامترهای موقعیت فعلی یا جدید ارگ ارزش های. هر تلاش دیگری برای استناد گرفتن
چندین بار در یک محیط اجرای تک پوسته با پارامترهای (موقعیتی
پارامترها یا ارگ عملوندها) که در همه فراخوانی ها یا با یک یکسان نیستند OPTIND
مقدار اصلاح شده به مقداری غیر از 1، نتایج نامشخصی تولید می کند.

OPTIONS

ندارد.

عملگرها

عملگرهای زیر باید پشتیبانی شوند:

optstring رشته‌ای حاوی کاراکترهای گزینه‌ای است که با فراخوانی ابزار شناسایی می‌شوند
گرفتن. اگر بعد از یک کاراکتر a ، گزینه مورد انتظار است
برای داشتن یک آرگومان، که باید به عنوان یک آرگومان جداگانه ارائه شود.
برنامه ها باید یک کاراکتر گزینه و آرگومان-گزینه آن را به عنوان مشخص کنند
استدلال های جداگانه، اما گرفتن باید شخصیت های زیر را تفسیر کند
کاراکتر گزینه ای که به آرگومان هایی به عنوان آرگومان نیاز دارد که آیا این کار انجام می شود یا نه.
اگر یک آرگومان گزینه تهی صریح و روشن ارائه نشده باشد، نیازی به شناسایی نیست
یک استدلال جداگانه وقتی گرفتن فراخوانی می شود. (همچنین نگاه کنید به گرفتن() تابع
در جلد System Interfaces POSIX.1-2008 تعریف شده است.) کاراکترها
و نباید به عنوان کاراکترهای گزینه توسط an استفاده شود
کاربرد. استفاده از کاراکترهای گزینه دیگر که حروف عددی نیستند
نتایج نامشخصی ایجاد می کند. اگر گزینه آرگومان به صورت الف ارائه نشده باشد
جدا کردن آرگومان از کاراکتر گزینه، مقدار in OPTARG باید باشد
از کاراکتر گزینه و '-'. شخصیت اول در optstring
چگونگی را تعیین می کند گرفتن اگر یک کاراکتر گزینه شناخته نشده باشد یا یک گزینه-
استدلال گم شده است

نام نام یک متغیر پوسته که باید توسط گرفتن سودمندی به
کاراکتر گزینه ای که پیدا شد

La گرفتن ابزار به طور پیش فرض باید پارامترهای موقعیتی ارسال شده به فراخوان را تجزیه کند
رویه پوسته اگر ارگs داده شده است، آنها باید به جای موقعیتی تجزیه شوند
پارامترها.

STDIN

استفاده نشده.

INPUT فایل ها

ندارد.

محیط زیست متغیرها

متغیرهای محیطی زیر باید بر اجرای آن تأثیر بگذارند گرفتن:

زبان یک مقدار پیش فرض برای متغیرهای بین المللی سازی که تنظیم نشده اند یا
خالی. (به جلد تعاریف پایه POSIX.1-2008 مراجعه کنید، بخش 8.2,
بین المللی کردن متغیر برای تقدم بین المللی شدن
متغیرهایی که برای تعیین مقادیر دسته‌های محلی استفاده می‌شوند.)

LC_ALL اگر روی یک مقدار رشته ای غیر خالی تنظیم شده است، مقادیر بقیه را لغو کنید
متغیرهای بین المللی سازی

LC_CTYPE محلی را برای تفسیر توالی بایت های داده متنی تعیین کنید
به عنوان کاراکتر (به عنوان مثال، تک بایت در مقابل کاراکترهای چند بایتی در
آرگومان ها و فایل های ورودی).

LC_MESSAGES
محلی را که باید برای تأثیرگذاری بر قالب و محتویات استفاده شود، تعیین کنید
پیام های تشخیصی با خطای استاندارد نوشته شده است.

nlspath تعیین محل کاتالوگ پیام برای پردازش LC_MESSAGES.

OPTIND این متغیر باید توسط گرفتن ابزار به عنوان شاخص بعدی
استدلالی که باید پردازش شود

نامتقارن رویدادها

پیش فرض

با توجه به

استفاده نشده.

STDERR

هر زمان که خطایی تشخیص داده شود و اولین کاراکتر در optstring عملوند a نیست
(':'، یک پیام تشخیصی باید با خطای استاندارد با موارد زیر نوشته شود
اطلاعات در قالب نامشخص:

* نام برنامه فراخوانی باید در پیام مشخص شود. برنامه فراخوانی
نام باید مقدار پارامتر ویژه پوسته 0 باشد (نگاه کنید به بخش 2.5.2, ویژه
پارامترهای) در آن زمان گرفتن ابزار فراخوانی شده است. نامی معادل:

نام اصلی "$0"

ممکن است مورد استفاده قرار گیرد

* اگر گزینه ای یافت شد که در آن مشخص نشده بود optstring، این خطا شناسایی شده است
و کاراکتر گزینه نامعتبر باید در پیام مشخص شود.

* اگر گزینه ای که نیاز به گزینه-استدلال دارد یافت شود، اما گزینه-استدلال پیدا نشود
پیدا شد، این خطا باید شناسایی شود و کاراکتر گزینه نامعتبر باشد
در پیام مشخص شده است.

OUTPUT فایل ها

ندارد.

تمدید شده شرح

ندارد.

خروج وضعیت

مقادیر خروجی زیر باید برگردانده شوند:

0 یک گزینه، مشخص یا نامشخص توسط optstring، یافت شد.

> 0 پایان گزینه ها مواجه شد یا خطایی رخ داد.

آثار OF خطاها

پیش فرض

La پیروی بخش هستند آموزنده

کاربرد طریقه استفاده

پس از گرفتن محیط اجرای پوسته فعلی را تحت تأثیر قرار می دهد، به طور کلی به عنوان ارائه می شود
یک پوسته توکار معمولی اگر در یک زیر پوسته یا اجرای ابزار جداگانه فراخوانی شود
محیطی مانند یکی از موارد زیر:

(می گیرد الفبا ارزش "$@")
نوهوپ گرفتن ...
پیدا کردن . -اجرایی گرفتن ... \;

بر متغیرهای پوسته در محیط تماس گیرنده تأثیر نمی گذارد.

توجه داشته باشید که توابع پوسته به اشتراک گذاشته می شوند OPTIND با پوسته فراخوان حتی اگر موقعیتی باشد
پارامترها تغییر می کند اگر پوسته فراخوان و هر یک از توابع آن استفاده می کند گرفتن به
تجزیه آرگومان ها، نتایج نامشخص هستند.

مثال ها

اسکریپت مثال زیر آرگومان های آن را تجزیه و نمایش می دهد:

افلاگ=
bflag=
در حین گرفتن ab: نام
do
مورد $name in
a) aflag=1;;
b) bflag=1
bval="$OPTARG";;
?) printf "استفاده: %s: [−a] [-b ارزش] args\n" $0
خروج 2 ؛
که C
انجام شده
if [ ! −z "$aflag" ]; سپس
printf "گزینه -a مشخص شده\n"
fi
if [ ! −z "$bflag" ]; سپس
printf 'گزینه -ب "%s" مشخص شده\n' "$bval"
fi
تغییر $(($OPTIND - 1/XNUMX/XNUMX))
printf "باقی مانده است استدلال هستند: %s\n$*"

منطقی

La گرفتن ابزار در اولویت نسبت به System V انتخاب شد گرفتن سودمندی چون
گرفتن دسته آرگومان های گزینه شامل شخصیت ها.

La OPTARG متغیر در بخش ENVIRONMENT VARIABLES ذکر نشده است زیرا ذکر شده است
بر اجرای گرفتن; این یکی از معدود متغیرهای «فقط خروجی» مورد استفاده است
توسط تاسیسات استاندارد

در به عنوان یک شخصیت گزینه مجاز نیست زیرا این رفتار تاریخی نیست،
و دستورالعمل های نحوی Utility را نقض می کند. در اکنون مشخص شده است که به عنوان رفتار کند
در نسخه KornShell از گرفتن سودمندی هنگامی که به عنوان اولین کاراکتر در
optstring عملوند، تشخیص مربوط به آرگومان‌های گزینه از دست رفته را غیرفعال می‌کند
کاراکترهای گزینه غیرمنتظره این جایگزین استفاده از OPTERR متغیری که بود
در یک پیشنهاد اولیه مشخص شده است.

فرمت های پیام های تشخیصی تولید شده توسط گرفتن ابزار و گرفتن()
تابع به طور کامل مشخص نشده است زیرا پیاده سازی هایی با برتر ("دوستان")
فرمت هایی که به فرمت های مورد استفاده توسط برخی از پیاده سازی های تاریخی اعتراض داشتند. استاندارد
توسعه دهندگان این نکته را مهم می دانند که اطلاعات موجود در پیام های مورد استفاده یکنواخت باشد
میان گرفتن و گرفتن(). ممکن است تکرار دقیق پیام ها امکان پذیر نباشد،
به خصوص اگر ابزاری بر روی سیستم دیگری ساخته شده باشد که سیستم متفاوتی دارد گرفتن()
عملکرد، اما پیام ها باید دارای اطلاعات خاصی باشند تا برنامه
نام، کاراکتر گزینه نامعتبر و نوع خطا توسط کاربر قابل تشخیص است.

فقط یک برنامه کاربردی نادر a را رهگیری می کند گرفتن پیام خطای استاندارد و می خواهد
آن را تجزیه کنید بنابراین، پیاده‌سازی‌ها در انتخاب قابل استفاده‌ترین پیام‌هایی که می‌توانند آزادند
تدبیر فرمت های زیر توسط بسیاری از پیاده سازی های تاریخی استفاده می شود:

"%s: غیر قانونی انتخاب --- %c\n"، <برنامه نام>, <انتخاب شخصیت>

"%s: گزینه به آرگومان نیاز دارد −- %c\n"،برنامه نام>، \
<انتخاب شخصیت>

پوسته های تاریخی با نسخه های داخلی گرفتن() یا گرفتن متفاوت استفاده کرده اند
فرمت‌ها، اغلب حتی کاراکتر گزینه‌ای که به اشتباه پیدا شده است را نشان نمی‌دهند.

آینده جهت

ندارد.

با استفاده از خدمات onworks.net از getoptsposix آنلاین استفاده کنید