getopt - Интернет в облаке

ПРОГРАММА:

ИМЯ

getopt - параметры команды синтаксического анализа (улучшено)

СИНТАКСИС

Getopt строка опций параметры
Getopt [параметры] [--] строка опций параметры
Getopt [опции] -o|--параметры строка опций [параметры] [--] параметры

ОПИСАНИЕ

Getopt используется для разрыва (разбор) в командной строке для облегчения анализа оболочкой
процедуры и проверить наличие юридических вариантов. Он использует GNU Getopt(3) процедуры, которые нужно выполнить
.

Параметры Getopt вызывается с помощью можно разделить на две части: параметры, которые изменяют
пути Getopt выполнит синтаксический анализ ( кредита и строка опций в СИНТАКСИС), а также расширение
параметры, которые нужно проанализировать (параметры в СИНТАКСИС). Вторая часть будет
начать с первого параметра, не являющегося параметром параметра, который не является аргументом параметра, или после первого
Возникновение '--'. Если нет '-o' или же '--параметры'вариант находится в первой части,
Первый параметр второй части используется как короткая строка опций.

Если переменная среды GETOPT_COMPATIBLE установлен, или если первый параметр это не
вариант (не начинается с '-', первый формат в СИНТАКСИС), Getopt будет генерировать
вывод, совместимый с другими версиями Getopt(1). Это все еще будет делать
перемешивание параметров и распознавание необязательных аргументов (см. раздел СОВМЕСТИМОСТЬ для большего
Информация).

Традиционные реализации Getopt(1) не справляются с пробелами и другими
(зависящие от оболочки) специальные символы в аргументах и ​​параметрах, не являющихся опциями. Чтобы решить эту проблему
проблема, эта реализация может генерировать цитируемый вывод, который снова должен быть
интерпретируется оболочкой (обычно с помощью Eval команда). Это имеет эффект
сохранение этих персонажей, но вы должны позвонить Getopt таким образом, который больше не
совместим с другими версиями (второй или третий формат в СИНТАКСИС). Чтобы определить
была ли эта расширенная версия Getopt(1) установлена ​​специальная тестовая опция (-T) может быть
используемый.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-a, - альтернатива
Разрешить длинные варианты начинаться с одного '-'.

-h, --Помогите
Показать текст справки и выйти. Никаких других выходных данных не создается.

-l, --longoptions Longopts
Распознаваемые длинные (многосимвольные) параметры. Может быть указано несколько названий опций.
указывать сразу, разделяя имена запятыми. Этот вариант может быть
дано более одного раза, Longopts накапливаются. Каждое длинное название опции в
Longopts может сопровождаться одним двоеточием, чтобы указать, что у него есть обязательный аргумент, и
двумя двоеточиями, чтобы указать, что у него есть необязательный аргумент.

-n, --имя имя программы
Имя, которое будет использовать Getopt(3) процедуры, когда он сообщает об ошибках. Примечание
что ошибки Getopt(1) по-прежнему считаются исходящими от getopt.

-o, --параметры шортопты
Распознаваемые короткие (односимвольные) параметры. Если этот вариант не найден,
первый параметр Getopt это не начинается с '-'(и это не вариант
аргумент) используется как короткая строка параметров. Каждый короткий вариант символа в
шортопты может сопровождаться одним двоеточием, чтобы указать, что у него есть обязательный аргумент, и
двумя двоеточиями, чтобы указать, что у него есть необязательный аргумент. Первый персонаж
шортопты могут быть+' или же '-'чтобы повлиять на способ анализа параметров и вывода
сгенерировано (см. раздел СКАНИРОВАНИЕ РЕЖИМЫ для более подробной информации).

-q, --тихий
Отключить отправку отчетов об ошибках Getopt(3).

-Q, - тихий выход
Не генерировать нормальный вывод. Об ошибках по-прежнему сообщает Getopt(3), если вы
также использовать -q.

-s, --оболочка оболочка
Установите правила цитирования в соответствии с оболочка, Если -s вариант не указан, BASH
используются условные обозначения. Действительные аргументы в настоящее время 'sh''колотить''CSH', а также
'Tcsh'.

-T, --тестовое задание
Проверьте, если ваш Getopt(1) это расширенная версия или старая версия. Это порождает
нет вывода и устанавливает статус ошибки на 4. Другие реализации Getopt(1), и
эта версия, если переменная среды GETOPT_COMPATIBLE установлен, вернется '--'
и статус ошибки 0.

-u, - не цитируется
Не цитируйте вывод. Обратите внимание, что пробелы и специальные (зависящие от оболочки)
персонажи могут вызвать хаос в этом режиме (как они делают с другими Getopt(1)
реализации).

-V, --версия
Вывести информацию о версии и выйти. Никаких других выходных данных не создается.

РАЗБОР

В этом разделе указывается формат второй части параметров Getopt (
параметры в СИНТАКСИС). Следующий раздел (ВЫВОД) описывает результат, который
сгенерировано. Эти параметры обычно были параметрами, которые вызывалась функция оболочки.
с участием. Необходимо следить за тем, чтобы каждый параметр, с которым вызывалась функция оболочки,
соответствует ровно одному параметру в списке параметров Getopt (См ПРИМЕРЫ).
Весь синтаксический анализ выполняется GNU Getopt(3) процедуры.

Параметры анализируются слева направо. Каждый параметр классифицируется как краткий
option, длинная опция, аргумент опции или параметр, не являющийся опцией.

Простой короткий вариант - это '-'с последующим коротким символом выбора. Если у опции есть
обязательный аргумент, он может быть написан сразу после символа опции или как следующий
параметр (т.е. разделенные пробелом в командной строке). Если у опции есть
необязательный аргумент, он должен быть написан непосредственно после символа опции, если он присутствует.

Можно указать несколько коротких опций после одного '-', пока все (кроме
возможно, последний) не имеют обязательных или необязательных аргументов.

Длинный вариант обычно начинается с '--'с последующим длинным названием опции. Если вариант
имеет обязательный аргумент, его можно записать сразу после длинного имени параметра, разделенного
по '=', или в качестве следующего аргумента (т. е. разделенных пробелом в командной строке). Если
у опции есть необязательный аргумент, он должен быть написан сразу после длинной опции
имя, разделенное '=', если есть (если вы добавите'='но ничего не стоит за этим, это
интерпретируется как отсутствие аргументов; это небольшая ошибка, см. ОШИБКИ). Длинный
параметры могут быть сокращены, если аббревиатура не является двусмысленной.

Каждый параметр, не начинающийся с символа '-', а не обязательный аргумент предыдущей опции,
не является опционным параметром. Каждый параметр после '--'параметр всегда интерпретируется как
параметр, не являющийся опцией. Если переменная среды POSIXLY_CORRECT установлен, или если
короткая строка параметров, начинающаяся с символа '+', все остальные параметры интерпретируются как
параметры, не являющиеся опциями, как только будет обнаружен первый параметр, не являющийся опцией.

ВЫВОД

Вывод создается для каждого элемента, описанного в предыдущем разделе. Вывод осуществляется в
тот же порядок, что и элементы, указанные во входных данных, за исключением неопции
параметры. Вывод может быть выполнен в совместим (не цитируется) режим, или таким образом, чтобы
пробелы и другие специальные символы в аргументах и ​​параметрах, не являющихся опциями,
сохранились (см. ЦИТАТА). Когда вывод обрабатывается в сценарии оболочки, он будет казаться
состоять из отдельных элементов, которые можно обрабатывать один за другим (с помощью сдвига
команда на большинстве языков оболочки). Это несовершенно в режиме без кавычек, так как элементы могут быть
разделить в неожиданных местах, если они содержат пробелы или специальные символы.

Если есть проблемы с синтаксическим анализом параметров, например, из-за того, что обязательным аргументом является
не найден или опция не распознана, ошибка будет сообщена на stderr, там будет
не будет вывода для нарушающего элемента, и будет возвращен ненулевой статус ошибки.

Для краткого варианта, сингл '-'и символ опции генерируются как один параметр.
Если у опции есть аргумент, следующим параметром будет аргумент. Если вариант
принимает необязательный аргумент, но он не был найден, следующий параметр будет сгенерирован, но
быть пустым в режиме цитирования, но второй параметр не будет сгенерирован без кавычек
(совместимый) режим. Обратите внимание, что многие другие Getopt(1) реализации не поддерживают необязательный
аргументы.

Если после одного '-', каждый будет присутствовать в
вывод как отдельный параметр.

Для длинного варианта,--'и полное имя опции генерируются как один параметр. Это
выполняется независимо от того, был ли параметр сокращен или указан с помощью одного '-' в
Вход. Аргументы обрабатываются так же, как и короткие варианты.

Обычно вывод параметров, не являющихся опциями, не создается до тех пор, пока все опции и их
были выдвинуты аргументы. Потом '--'генерируется как единственный параметр, а после него
параметры, не являющиеся опциями, в том порядке, в котором они были найдены, каждый как отдельный параметр.
Только если первым символом короткой строки параметров был '-', неопциональный параметр
вывод генерируется в том месте, где они находятся на входе (это не поддерживается, если
первый формат СИНТАКСИС используется; в этом случае все предыдущие вхождения '-' а также
'+'игнорируются).

ЦИТАТА

В совместимом режиме пробелы или специальные символы в аргументах или без параметра
параметры обрабатываются неправильно. Когда вывод передается в сценарий оболочки,
скрипт не знает, как предполагается разбить вывод на отдельные параметры. К
Чтобы обойти эту проблему, эта реализация предлагает цитирование. Идея в том, что результат
создается с кавычками вокруг каждого параметра. Когда этот выход снова подается на
оболочка (обычно оболочкой Eval команда), она правильно разбита на отдельные параметры.

Цитирование не включено, если переменная среды GETOPT_COMPATIBLE устанавливается, если первый
форма СИНТАКСИС используется, или если опция '-u' найден.

В разных оболочках используются разные соглашения о кавычках. Вы можете использовать '-s'возможность выбора
оболочку, которую вы используете. В настоящее время поддерживаются следующие оболочки: 'sh''колотить',
'CSH'И'Tcsh'. На самом деле различают только два «вкуса»: цитирование типа sh
соглашения и соглашения о цитировании, подобные csh. Скорее всего, если вы воспользуетесь другой оболочкой
скриптовый язык, можно использовать один из этих вариантов.

СКАНИРОВАНИЕ РЕЖИМЫ

Первым символом короткой строки параметров может быть '-'или'+'для обозначения
специальный режим сканирования. Если первая вызывающая форма в СИНТАКСИС используется они
игнорируется; переменная окружения POSIXLY_CORRECT тем не менее, все еще исследуется.

Если первый символ - '+', или если переменная среды POSIXLY_CORRECT установлен,
анализ останавливается, как только первый параметр, не являющийся опцией (т. е. параметр, который не
начать с '-'), который не является аргументом опции. Остальные параметры
все интерпретируются как параметры, не являющиеся опциями.

Если первый символ - это '-', неопциональные параметры выводятся в том месте, где
они найдены; при нормальной работе все они собираются в конце вывода после
'--'параметр был сгенерирован. Обратите внимание, что это '--'параметр все еще генерируется, но
в этом режиме он всегда будет последним параметром.

СОВМЕСТИМОСТЬ

Эта версия Getopt(1) написан для максимальной совместимости с другими версиями.
Обычно вы можете просто заменить их этой версией без каких-либо модификаций, и на
некоторые преимущества.

Если первый символ первого параметра getopt не является '-', Getopt переходит в
режим совместимости. Он интерпретирует свой первый параметр как строку коротких опций,
и все остальные аргументы будут проанализированы. Он по-прежнему будет перетасовывать параметры (т. Е. Все
неопциональные параметры выводятся в конце), если переменная среды
POSIXLY_CORRECT установлен.

Переменная окружения GETOPT_COMPATIBLE сил Getopt в режим совместимости. Параметр
как эта переменная среды, так и POSIXLY_CORRECT предлагает 100% совместимость для
«сложные» программы. Однако обычно ни то, ни другое не требуется.

В режиме совместимости ведущие '-'И'+'символы в короткой строке параметров
игнорируются.

ВЕРНУТЬ КОДЫ

Getopt возвращает код ошибки 0 для успешного парсинга, 1 if Getopt(3) возвращает ошибки, 2 если оно
не понимает собственных параметров, 3 если возникает внутренняя ошибка, например нехватка памяти,
и 4 если он вызывается с -T.

ПРИМЕРЫ

Примеры сценариев для (ba) sh и (t) csh предоставляются с Getopt(1) распределение и
опционально устанавливаются в / usr / share / getopt / or / usr / share / doc / в util-linux
подкаталог.

ОКРУЖАЮЩАЯ СРЕДА

POSIXLY_CORRECT
Эта переменная среды проверяется Getopt(3) процедуры. Если он установлен,
анализ останавливается, как только обнаруживается параметр, не являющийся опцией или опцией
аргумент. Все остальные параметры также интерпретируются как параметры, не являющиеся опциями,
независимо от того, начинаются ли они с символа '-'.

GETOPT_COMPATIBLE
Войска Getopt использовать первый формат вызова, как указано в СИНТАКСИС.

Используйте getopt онлайн с помощью сервисов onworks.net