getoptsposix — online w chmurze

PROGRAM:

IMIĘ

getopts — analizuje opcje narzędzi

STRESZCZENIE

getopty ciąg znaków Nazwa [arg...]

OPIS

Połączenia getopty narzędzie powinno pobierać opcje i argumenty opcji z listy parametrów.
Będzie obsługiwać Wytyczne dotyczące składni narzędzi od 3 do 10 włącznie, opisane w Bazie
Tom Definicje POSIX.1‐2008, Sekcja 12.2, Użyteczność Składnia Wytyczne.

Za każdym razem, gdy jest wywoływany, tzw getopty narzędzie umieści wartość następnej opcji w
zmienna powłoki określona przez Nazwa operand i indeks następnego argumentu, który ma być
przetwarzane w zmiennej powłoki OPTYCZNY. Ilekroć wywoływana jest powłoka, OPTYCZNY niech będzie
zainicjowany na 1.

Gdy opcja wymaga argumentu-opcji, getopty narzędzie umieści go w
zmienna powłoki OPTARG. Jeśli nie znaleziono żadnej opcji lub jeśli znaleziona opcja nie została znaleziona
mieć argument-opcję, OPTARG zostanie rozbrojony.

Jeśli znak opcji nie jest zawarty w ciąg znaków argument znajduje się tam, gdzie opcja
oczekiwany jest znak, zmienna powłoki określona przez Nazwa zostanie ustawiony na
znak> ('?') postać. W tym przypadku, jeśli pierwszy znak w ciąg znaków jest
(':'), zmienna powłoki OPTARG należy ustawić na znaleziony znak opcji, ale bez wyjścia
należy zapisać z błędem standardowym; w przeciwnym razie zmienna powłoki OPTARG zostanie rozbrojony
a komunikat diagnostyczny zostanie zapisany do błędu standardowego. Ten warunek będzie
uznano za błąd wykryty w sposobie przedstawiania argumentów powołującemu
aplikacji, ale nie może być błędem getopty przetwarzanie.

Jeśli brakuje argumentu-opcji:

* Jeśli pierwszy znak ciąg znaków jest , zmienna powłoki określona przez Nazwa
zostanie ustawiony na znak i zmienną powłoki OPTARG zostanie ustawiony na
znaleziony znak opcji.

* W przeciwnym razie zmienna powłoki określona przez Nazwa zostanie ustawiony na
znak, zmienna powłoki OPTARG powinien być wyłączony, a komunikat diagnostyczny powinien być wyłączony
zapisany z błędem standardowym. Warunek ten uznaje się za wykryty błąd
w sposób, w jaki argumenty zostały przedstawione wnioskowi powołującemu się, ale nie może być
bład w getopty przetwarzanie; komunikat diagnostyczny powinien być zapisany zgodnie z opisem, ale
status wyjścia wynosi zero.

Gdy napotkany zostanie koniec opcji, plik getopty narzędzie zakończy się z wartością zwracaną
większy od zera; zmienna powłoki OPTYCZNY zostanie ustawiony na indeks pierwszego
operand lub wartość „$#”+1 jeśli nie ma operandów; the Nazwa zmienna powinna być ustawiona na
the postać. Każda z poniższych informacji określa koniec opcji: the
drugim „--” argument, który nie jest argumentem-opcją, znajdowanie argumentu, który nie jest argumentem
argument-opcja i nie zaczyna się od a '-'lub wystąpił błąd.

Zmienne powłoki OPTYCZNY i OPTARG będzie lokalny dla dzwoniącego z getopty i będzie
nie mogą być eksportowane domyślnie.

Zmienna powłoki określona przez Nazwa argument, OPTYCZNY, OPTARG wpłynie na
obecne środowisko wykonawcze powłoki; Widzieć Sekcja 2.12, Powłoka Egzekucja Środowisko.

Jeśli aplikacja ustawi OPTYCZNY do wartości 1 można zastosować nowy zestaw parametrów: albo
aktualne parametry pozycyjne lub nowe arg wartości. Każda inna próba wywołania getopty
wiele razy w jednym środowisku wykonawczym powłoki z parametrami (pozycyjne
parametry lub arg operandy), które nie są takie same we wszystkich wywołaniach, lub z an OPTYCZNY
wartość zmodyfikowana na wartość inną niż 1, daje nieokreślone wyniki.

OPCJE

Brak.

OPERANDY

Obsługiwane będą następujące argumenty:

ciąg znaków Ciąg zawierający znaki opcji rozpoznawane przez wywołujące narzędzie
getopty. Jeśli po znaku następuje a należy oczekiwać opcji
mieć argument, który należy podać jako osobny argument.
Aplikacje powinny określać znak opcji i jego argument-opcję jako
oddzielne argumenty, ale getopty interpretuje znaki następujące po an
znak opcji wymagający argumentów jako argument, niezależnie od tego, czy jest to zrobione.
Wyraźny pusty argument-opcja nie musi być rozpoznawany, jeśli nie jest podany jako
osobny argument kiedy getopty jest wywoływany. (Zobacz też getopt() funkcja
zdefiniowane w woluminie System Interfaces w POSIX.1‐2008.) Znaki
I nie mogą być używane jako znaki opcji przez an
aplikacja. Użycie innych znaków opcji, które nie są alfanumeryczne
daje nieokreślone wyniki. Jeśli argument-opcja nie jest podany jako a
oddzielić argument od znaku opcji, wartość w OPTARG niech będzie
pozbawiony znaku opcji i '-'. Pierwsza postać w ciąg znaków
określa jak getopty zachowuje się, jeśli znak opcji nie jest znany lub opcja-
brakuje argumentu.

Nazwa Nazwa zmiennej powłoki, która ma być ustawiona przez getopty użyteczność do
znaleziony znak opcji.

Połączenia getopty Narzędzie domyślnie analizuje parametry pozycyjne przekazywane do wywołania
procedura powłoki. Jeśli args są podane, będą one analizowane zamiast pozycyjnych
parametry.

STDIN

Nieużywany.

WEJŚCIE AKTA

Brak.

ŚRODOWISKO ZMIENNE

Następujące zmienne środowiskowe mają wpływ na wykonanie getopty:

JĘZYK Podaj wartość domyślną dla zmiennych internacjonalizacji, które nie są ustawione lub
zero. (Patrz tom Definicje podstawowe POSIX.1‐2008, Sekcja 8.2,
Umiędzynarodowienie Zmienne o pierwszeństwo internacjonalizacji
zmienne używane do określania wartości kategorii ustawień regionalnych).

LC_ALL Jeśli jest ustawiony na niepustą wartość ciągu, nadpisz wartości wszystkich pozostałych
zmienne internacjonalizacji.

LC_CTYPE Określ lokalizację dla interpretacji sekwencji bajtów danych tekstowych
jako znaki (na przykład jednobajtowe w przeciwieństwie do wielobajtowych znaków w
argumenty i pliki wejściowe).

LC_MESSAGES
Określ ustawienia regionalne, które powinny być używane do wpływania na format i zawartość
komunikaty diagnostyczne zapisywane z błędem standardowym.

NLSPATH Określ lokalizację katalogów wiadomości do przetwarzania LC_MESSAGES.

OPTYCZNY Zmienna ta będzie używana przez getopty użyteczność jako wskaźnik następnej
argument do przetworzenia.

ASYNCHRONICZNY WYDARZENIA

Domyślna.

STDOUT

Nieużywany.

STDERR

Za każdym razem, gdy zostanie wykryty błąd, a pierwszy znak w pliku ciąg znaków argument nie jest a
(':'), komunikat diagnostyczny zostanie zapisany do błędu standardowego o następującej treści
informacje w nieokreślonym formacie:

* W komunikacie należy podać nazwę programu wywołującego. Program wywołujący
name będzie wartością specjalnego parametru powłoki 0 (patrz Sekcja 2.5.2, Specjalny
parametry) w czasie getopty narzędzie jest wywoływane. Imię równoważne z:

nazwa podstawowa „0 USD”

może być użyty.

* Jeśli zostanie znaleziona opcja, która nie została określona w ciąg znaków, ten błąd został zidentyfikowany
oraz znak nieważnej opcji zostanie zidentyfikowany w komunikacie.

* Jeśli zostanie znaleziona opcja wymagająca argumentu-opcji, ale argumentu-opcji nie ma
zostanie znaleziony, ten błąd zostanie zidentyfikowany, a znak nieważnej opcji zostanie określony
zidentyfikowane w wiadomości.

WYDAJNOŚĆ AKTA

Brak.

ROZSZERZONY OPIS

Brak.

EXIT STATUS

Zwracane są następujące wartości wyjściowe:

0 Opcja, określona lub nieokreślona przez ciąg znaków, został znaleziony.

>0 Napotkano koniec opcji lub wystąpił błąd.

KONSEKWENCJE OF BŁĘDY

Domyślna.

Połączenia następujący działy jest informacyjny.

WNIOSEK ZASTOSOWANIE

Ponieważ getopty wpływa na bieżące środowisko wykonywania powłoki, jest ogólnie udostępniane jako
zwykła wbudowana powłoka. Jeśli jest wywoływany w podpowłoce lub wykonaniu oddzielnego narzędzia
środowisko, takie jak jedno z poniższych:

(getopty ABC wartość "$@")
noup getopty ...
odnaleźć . −wykon getopty ... \;

nie wpływa na zmienne powłoki w środowisku wywołującego.

Zauważ, że funkcje powłoki współdzielą OPTYCZNY z wywołującą powłoką, mimo że pozycyjna
parametry są zmieniane. Jeśli wywołująca powłoka i dowolna z jej funkcji używa getopty do
analizować argumenty, wyniki są nieokreślone.

PRZYKŁADY

Poniższy przykładowy skrypt analizuje i wyświetla swoje argumenty:

flaga=
flaga b=
Podczas getopty od: Nazwa
do
walizka $ nazwa in
a) flaga = 1;;
b) flaga b=1
bval="$OPTARG";;
?) printf "Stosowanie: % s: [-a] [-ur wartość] argumenty\n" $0
wyjście 2;;
to C
zrobić
if [ ! −z „$flaga” ]; następnie
printf "Opcja -a określony\n"
fi
if [ ! −z „$bflaga” ]; następnie
printf 'Opcja −b "%s" określony\n' „$ bval”
fi
przesunięcie $(($ IND.OPTYCZ - 1))
printf "Pozostały argumenty należą: %s\n$*"

RACJONALNE UZASADNIENIE

Połączenia getopty narzędzie zostało wybrane zamiast Systemu V getopt użyteczność, ponieważ
getopty obsługuje argumenty opcji zawierające postacie.

Połączenia OPTARG zmienna nie jest wymieniona w sekcji ZMIENNE ŚRODOWISKOWE, ponieważ tak jest
nie wpływają na wykonanie getopty; jest to jedna z niewielu używanych zmiennych ``wyjściowych''
przez standardowe narzędzia.

The nie jest dozwolony jako znak opcji, ponieważ nie jest to zachowanie historyczne,
i narusza wytyczne dotyczące składni narzędzi. The jest teraz określone, aby zachowywać się jak
w wersji KornShell getopty pożytek; gdy jest używany jako pierwszy znak w
ciąg znaków operand, wyłącza diagnostykę dotyczącą brakujących argumentów-opcji i
nieoczekiwane znaki opcji. Zastępuje to użycie tzw OPTERR zmienna to była
określone we wstępnej propozycji.

Formaty komunikatów diagnostycznych generowanych przez program getopty użyteczność i getopt()
funkcja nie jest w pełni określona, ​​ponieważ implementacje z nadrzędnym (``przyjaźniejszym'')
formaty sprzeciwiały się formatom używanym przez niektóre historyczne implementacje. Norma
programiści uznali za ważne, aby informacje w używanych komunikatach były jednolite
pomiędzy getopty i getopt(). Dokładne powielenie wiadomości może nie być możliwe,
zwłaszcza jeśli narzędzie jest zbudowane na innym systemie, który ma inny getopt()
funkcji, ale komunikaty muszą zawierać określone informacje, aby program
użytkownik może rozróżnić nazwę, znak nieprawidłowej opcji i typ błędu.

Tylko rzadka aplikacja przechwytuje a getopty standardowy komunikat o błędzie i chce
przeanalizuj to. Dlatego implementacje mają swobodę wyboru najbardziej użytecznych komunikatów
wymyślać. Następujące formaty są używane przez wiele historycznych implementacji:

"%s: nielegalny opcja −− %c\n", <program Nazwa>, <opcja charakter>

"%s: opcja wymaga argumentu −− %c\n",program Nazwa>, \
<opcja charakter>

Historyczne powłoki z wbudowanymi wersjami getopt() lub getopty użyłem innego
formatach, często nawet nie wskazując znaku opcji znalezionego jako błędny.

PRZYSZŁOŚĆ KIERUNKI

Brak.

Użyj getoptsposix online, korzystając z usług onworks.net