getoptsposix - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

getopts — розбір параметрів утиліти

СИНТАКСИС

getopts рядок параметрів ім'я [аргумент...]

ОПИС

Команда getopts Утиліта має отримати параметри та аргументи параметрів зі списку параметрів.
Він повинен підтримувати Інструкції з синтаксису утиліт 3-10 включно, описані в Базі
Том визначень POSIX.1-2008, розділ 12.2, Утиліта синтаксис керівні вказівки.

Кожен раз, коли його викликають, getopts утиліта поміщає значення наступної опції
змінна оболонки, зазначена в ім'я операнд та індекс наступного аргументу
обробляється у змінній оболонки OPTIND. Щоразу, коли викликається оболонка, OPTIND має бути
ініціалізовано на 1.

Коли для параметра потрібен аргумент-опція, то getopts утиліта повинна розмістити його в
змінна оболонки OPTARG. Якщо не знайдено жодного параметра, або якщо знайдений варіант не знайдено
мати варіант-аргумент, OPTARG буде вимкнено.

Якщо символ параметра не міститься в рядок параметрів операнд знаходиться там, де опція
очікується символ, змінна оболонки, визначена як ім'я встановлюється на
позначка> ('?') характер. У цьому випадку, якщо перший символ у рядок параметрів є
(':'), змінна оболонки OPTARG має бути встановлений символ параметра, знайдений, але не виведення
записується зі стандартною помилкою; інакше змінна оболонки OPTARG буде вимкнено
і діагностичне повідомлення має бути записано до стандартної помилки. Ця умова має бути
вважається помилкою, виявленою в тому, як аргументи були представлені для виклику
додаток, але не повинно бути помилкою getopts обробка

Якщо параметр-аргумент відсутній:

* Якщо перший символ рядок параметрів є , змінна оболонки, визначена як ім'я
встановлюється на символ і змінна оболонки OPTARG має бути встановлено на
знайдений символ параметра.

* В іншому випадку змінна оболонки, визначена як ім'я встановлюється на
символ, змінна оболонки OPTARG має бути скасовано, а діагностичне повідомлення має бути
записано зі стандартною помилкою. Ця умова розглядається як виявлена ​​помилка
у спосіб, яким були представлені аргументи заявці, яка посилається, але не має бути
помилка в getopts обробка; діагностичне повідомлення має бути написано, як зазначено, але
статус виходу має бути нульовим.

Коли зустрічається кінець параметрів, то getopts утиліта має вийти з поверненим значенням
більше нуля; змінна оболонки OPTIND має бути встановлений індекс першого
операнд або значення "$#"+1, якщо немає операндів; в ім'я змінна повинна бути встановлена ​​в
в характер. Будь-яке з наступного має ідентифікувати кінець варіантів: the
перший "−−" аргумент, який не є аргументом-варіантом, знаходження аргументу, який не є аргументом
параметр-аргумент і не починається з a '−', або виникла помилка.

Змінні оболонки OPTIND та OPTARG має бути локальним для абонента getopts і буде
не експортується за замовчуванням.

Змінна оболонки, зазначена в ім'я операнд, OPTIND та OPTARG вплине на
поточне середовище виконання оболонки; побачити розділ 2.12, Склад Виконання Навколишнє середовище.

Якщо програма встановлює OPTIND до значення 1 можна використовувати новий набір параметрів: або
поточні параметри позиції або нові аргумент цінності. Будь-яка інша спроба викликати getopts
кілька разів у середовищі виконання однієї оболонки з параметрами (позиційними
параметри або аргумент операнди), які не є однаковими у всіх викликах або з an OPTIND
значення, змінене на значення, відмінне від 1, дає невизначені результати.

ВАРІАНТИ

Ні.

ОПЕРАНДИ

Підтримуються такі операнди:

рядок параметрів Рядок, що містить символи параметрів, розпізнані утилітою
getopts. Якщо після символу стоїть a , варіант слід очікувати
мати аргумент, який слід надати як окремий аргумент.
Програми повинні вказувати символ параметра та його аргумент-аргумент як
окремі аргументи, але getopts має інтерпретувати символи після a
Символ параметра, який вимагає аргументів як аргументу, незалежно від того, зроблено це чи ні.
Явний нульовий аргумент-параметр не потрібно розпізнавати, якщо він не надається як
окремий аргумент, коли getopts викликається. (Див. також getopt() функція
визначено в томі системних інтерфейсів POSIX.1‐2008.) Символи
і не повинні використовуватися як символи опції an
додаток. Використання інших символів, які не є буквено-цифровими
дає невизначені результати. Якщо параметр-аргумент не надається як a
окремий аргумент від символу параметра, значення в OPTARG має бути
позбавлено символу параметра та символу '−'. Перший персонаж у рядок параметрів
визначає як getopts поводиться, якщо символ параметра невідомий або параметр-
аргумент відсутній.

ім'я Ім'я змінної оболонки, яка повинна бути встановлена getopts корисність для
Знайдений символ параметра.

Команда getopts Утиліта за замовчуванням аналізує параметри позиції, передані виклику
shell процедура. Якщо аргументs, вони повинні бути розібрані замість позиційних
параметри

STDIN

Не використовується.

ВХІД ФАЙЛИ

Ні.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

Наступні змінні середовища мають впливати на виконання getopts:

МОВА Надайте значення за замовчуванням для змінних інтернаціоналізації, які не встановлені або
нуль. (Дивіться том Base Definitions POSIX.1-2008, розділ 8.2,
Internationalization Змінні за пріоритет інтернаціоналізації
змінні, що використовуються для визначення значень категорій мовного стандарту.)

LC_ALL Якщо встановлено не порожнє значення рядка, замініть значення всіх інших
змінні інтернаціоналізації.

LC_CTYPE Визначте локаль для інтерпретації послідовностей байтів текстових даних
як символи (наприклад, однобайтові на відміну від багатобайтових символів у
аргументи та вхідні файли).

LC_MESSAGES
Визначте місцевий стандарт, який слід використовувати для впливу на формат і вміст
діагностичні повідомлення, записані у стандартну помилку.

NLSPATH Визначте розташування каталогів повідомлень для обробки LC_MESSAGES.

OPTIND Ця змінна буде використовуватися getopts корисність як індекс наступного
аргумент, що підлягає обробці.

АСИНХРОННИЙ ПОДІЇ

За замовчуванням.

ВИСТАВКА

Не використовується.

STDERR

Щоразу, коли виявляється помилка, і перший символ у файлі рядок параметрів операнд не є a
(':'), діагностичне повідомлення має бути записано до стандартної помилки з наступним
інформація у невизначеному форматі:

* Назва програми, що викликає, має бути визначена в повідомленні. Програма виклику
name має бути значенням спеціального параметра оболонки 0 (див розділ 2.5.2, спеціальний
параметри) на той час getopts викликається утиліта. Ім'я, еквівалентне:

базове ім'я "$0"

може використовуватися.

* Якщо знайдено варіант, який не вказано в рядок параметрів, ця помилка виявлена
і символ недопустимого параметра має бути ідентифікований у повідомленні.

* Якщо параметр, що вимагає аргумент-аргумент, знайдено, але аргумент-опція ні
знайдено, ця помилка повинна бути ідентифікована, а також недійсний символ параметра
визначені в повідомленні.

ВИХІД ФАЙЛИ

Ні.

ПОВЕРНЕНІ ОПИС

Ні.

EXIT СТАТУС

Повинні бути повернуті такі вихідні значення:

0 Опція, визначена або невизначена рядок параметрів, був знайдений.

>0 Виявлено кінець параметрів або сталася помилка.

НАСЛІДКИ OF ПОМИЛКИ

За замовчуванням.

Команда після розділам він має інформативний.

ЗАСТОСУВАННЯ ВИКОРИСТАННЯ

З getopts впливає на поточне середовище виконання оболонки, зазвичай надається як
звичайна вбудована оболонка. Якщо він викликається у підоболонці або в окремому виконанні утиліти
середовище, наприклад одне з наступних:

(gettopts Азбука значення "$@")
nohup getopts ...
знаходити . −викон getopts ... \;

це не впливає на змінні оболонки в середовищі абонента.

Зауважте, що функції оболонки спільні OPTIND з оболонкою виклику, навіть якщо позиційна
параметри змінюються. Якщо оболонка, що викликає, і будь-яка з її функцій використовує getopts до
аналізувати аргументи, результати не визначені.

ПРИКЛАДИ

Наступний приклад сценарію аналізує та відображає його аргументи:

aflag=
bflag=
в той час як getopts від: ім'я
do
випадок $name in
a) aflag=1;;
b) bflag=1
bval="$OPTARG";;
?) printf «Використання: %s: [−a] [−b значення] аргументи\n" $0
вихід 2???
що С
зроблений
if [ ! −z "$aflag" ]; потім
printf «Варіант −а зазначено\n"
fi
if [ ! −z "$bflag" ]; потім
printf 'Варіант −b "%s" вказано\n' "$bval"
fi
зсув $(($OPTIND - 1))
printf «Залишається аргументація є: %s\n$*"

ОБГОВОРЕННЯ

Команда getopts Утиліта була обрана на користь System V getopt корисність, тому що
getopts обробляє параметри-аргументи, що містять символів.

Команда OPTARG Змінна не згадується в розділі ЗМІННІ СЕРЕДОВИЩА, оскільки вона згадується
не впливають на виконання getopts; це одна з небагатьох використаних змінних "лише виведення".
стандартними утилітами.

The не дозволяється як символ опції, оскільки це не історична поведінка,
і це порушує вказівки щодо синтаксису утиліт. The тепер вказано для поведінки як
у версії KornShell getopts корисність; якщо використовується як перший символ у
рядок параметрів операнд, він відключає діагностику щодо відсутніх аргументів параметрів і
неочікувані опційні символи. Це замінює використання OPTERR змінна, яка була
зазначено в попередній пропозиції.

Формати діагностичних повідомлень, що виробляються getopts корисність і getopt()
функції не вказано повністю, оскільки реалізації з кращими (``дружнішими'')
формати заперечували проти форматів, які використовуються деякими історичними реалізаціями. Стандарт
розробники вважали важливим, щоб інформація в повідомленнях була однорідною
між getopts та getopt(). Точне копіювання повідомлень може бути неможливим,
особливо якщо утиліта побудована на іншій системі, яка має іншу getopt()
функція, але повідомлення повинні містити певну інформацію, щоб програма
Користувач може розрізнити ім'я, недійсний символ параметра та тип помилки.

Лише рідкісна прикладна програма перехоплює a getopts стандартне повідомлення про помилку і хоче
розібрати його. Таким чином, реалізації можуть вільно вибирати найбільш корисні повідомлення, які вони можуть
придумати. У багатьох історичних реалізаціях використовуються такі формати:

"%s: незаконний варіант −− %c\n", <програма ім'я>, <варіант характер>

"%s: параметр вимагає аргумент −− %c\n",програма ім'я>, \
<варіант характер>

Історичні оболонки з вбудованими версіями getopt() або getopts використовували різні
форматів, часто навіть не вказуючи символ опції, знайдений помилково.

Майбутнє НАПРЯМКИ

Ні.

Використовуйте getoptsposix онлайн за допомогою служб onworks.net