getoptsposix - Online în cloud

PROGRAM:

NUME

getopts — analizează opțiunile utilitare

REZUMAT

getopts optstring nume [arg...]

DESCRIERE

getopts utilitarul va prelua opțiunile și argumentele opțiunii dintr-o listă de parametri.
Acesta va sprijini Liniile directoare de sintaxă de utilitate 3 până la 10, inclusiv, descrise în bază
Volumul definițiilor POSIX.1‐2008, Secțiune 12.2, Utilitate Sintaxă Instrucțiuni.

De fiecare dată când este invocat, getopts utilitatea va plasa valoarea următoarei opțiuni în
variabila shell specificată de nume operand și indexul următorului argument care urmează să fie
procesate în variabila shell OPTIND. Ori de câte ori shell-ul este invocat, OPTIND ar trebui sa fie
initializat la 1.

Când opțiunea necesită un argument-opțiune, getopts utilitatea îl va plasa în
variabila shell OPTARG. Dacă nu a fost găsită nicio opțiune sau dacă opțiunea care a fost găsită nu
au un argument-opțiune, OPTARG va fi dezactivat.

Dacă un caracter de opțiune nu este conținut în optstring operand este găsit acolo unde o opțiune
este așteptat, variabila shell specificată de nume va fi setat la
marca> ('?') caracter. În acest caz, dacă primul caracter din optstring este o
(':'), variabila shell OPTARG va fi setat la caracterul opțiune găsit, dar nicio ieșire
se scrie la eroare standard; în caz contrar, variabila shell OPTARG va fi dezactivat
și se scrie un mesaj de diagnosticare la eroare standard. Această condiție va fi
considerată a fi o eroare detectată în modul în care argumentele au fost prezentate la invocare
aplicație, dar nu trebuie să fie o eroare getopts prelucrare.

Dacă lipsește un argument-opțiune:

* Dacă primul caracter al optstring este o , variabila shell specificată de nume
va fi setat la caracterul și variabila shell OPTARG va fi setat la
caracterul opțiune găsit.

* În caz contrar, variabila shell specificată de nume va fi setat la
caracter, variabila shell OPTARG va fi dezactivat și va fi un mesaj de diagnosticare
scris la eroare standard. Această condiție va fi considerată o eroare detectată
în modul în care au fost prezentate argumentele cererii invocatoare, dar nu trebuie să fie un
eroare în getopts prelucrare; un mesaj de diagnosticare va fi scris așa cum este menționat, dar
starea de ieșire va fi zero.

Când se întâlnește sfârșitul opțiunilor, getopts utilitatea va ieși cu o valoare returnată
mai mare decât zero; variabila shell OPTIND va fi setat la indexul primului
operand sau valoarea „$ #”+1 dacă nu există operanzi; cel nume variabila va fi setată la
cel caracter. Oricare dintre următoarele va identifica sfârșitul opțiunilor: the
primul "--" argument care nu este un argument-opțiune, găsirea unui argument care nu este un
opțiune-argument și nu începe cu a '-', sau întâmpinați o eroare.

Variabilele shell OPTIND și OPTARG va fi local pentru apelantul getopts și va
nu poate fi exportat implicit.

Variabila shell specificată de nume operand, OPTIND, și OPTARG va afecta
mediul curent de execuție shell; vedea Secțiune 2.12, Coajă Execuție Mediu inconjurator.

Dacă aplicația se setează OPTIND la valoarea 1 se poate folosi un nou set de parametri: fie
parametrii poziționali actuali sau noi arg valorile. Orice altă încercare de a invoca getopts
de mai multe ori într-un singur mediu de execuție shell cu parametri (pozițional
parametrii sau arg operanzi) care nu sunt aceiași în toate invocările sau cu un OPTIND
valoare modificată pentru a fi o altă valoare decât 1, produce rezultate nespecificate.

OPŢIUNI

Nici unul.

OPERANDE

Următorii operanzi vor fi acceptați:

optstring Un șir care conține caracterele opțiunilor recunoscute de invocarea utilitarului
getopts. Dacă un caracter este urmat de a , opțiunea este de așteptat
a avea un argument, care ar trebui să fie furnizat ca argument separat.
Aplicațiile ar trebui să specifice un caracter de opțiune și argumentul său opțiune ca
argumente separate, dar getopts va interpreta personajele care urmează an
caracter de opțiune care necesită argumente ca argument indiferent dacă se face sau nu acest lucru.
Un argument-opțiune nul explicit nu trebuie să fie recunoscut dacă nu este furnizat ca
un argument separat când getopts este invocat. (Vezi, de asemenea, getopt() funcție
definite în volumul System Interfaces din POSIX.1‐2008.) Caracterele
și nu vor fi folosite ca caractere opționale de către un
aplicarea. Utilizarea altor caractere opționale care nu sunt alfanumerice
produce rezultate nespecificate. Dacă argumentul-opțiune nu este furnizat ca a
argument separat de caracterul opțiunii, valoarea în OPTARG ar trebui sa fie
dezbrăcat de caracterul opțiune și de '-'. Primul personaj din optstring
determină cum getopts se comportă dacă un caracter de opțiune nu este cunoscut sau o opțiune-
argumentul lipsește.

nume Numele unei variabile shell care va fi setat de getopts utilitate la
caracterul de opțiune care a fost găsit.

getopts utilitatea în mod implicit va analiza parametrii poziționali trecuți la invocare
procedura shell. Dacă argsunt date, acestea vor fi analizate în loc de pozițional
parametri.

Stdin

Nefolosit.

INTRARE DOSARE

Nici unul.

MEDIUL VARIABILE

Următoarele variabile de mediu vor afecta execuția getopts:

LIMBA Furnizați o valoare implicită pentru variabilele de internaționalizare care sunt nesetate sau
nul. (A se vedea volumul Definiții de bază din POSIX.1‐2008, Secțiune 8.2,
Internaționalizare Variabile pentru prioritatea internaţionalizării
variabile utilizate pentru a determina valorile categoriilor locale.)

LC_ALL Dacă este setată la o valoare șir nevid, suprascrieți valorile tuturor celorlalte
variabile de internaţionalizare.

LC_CTYPE Determinați locația pentru interpretarea secvențelor de octeți de date text
ca caractere (de exemplu, caractere pe un singur octet, spre deosebire de caractere pe mai mulți octeți în
argumente și fișiere de intrare).

LC_MESSAGES
Determinați locația care ar trebui utilizată pentru a afecta formatul și conținutul
mesaje de diagnostic scrise la eroare standard.

NLSPATH Determinați locația cataloagelor de mesaje pentru procesarea LC_MESSAGES.

OPTIND Această variabilă va fi utilizată de către getopts utilitate ca indice al următoarei
argument de prelucrat.

ASINCRON EVENIMENTE

Implicit.

Stdout

Nefolosit.

Stderr

Ori de câte ori este detectată o eroare și primul caracter din optstring operand nu este a
(':'), se scrie un mesaj de diagnosticare la eroare standard cu următoarele
informații într-un format nespecificat:

* Numele programului de invocare va fi identificat în mesaj. Programul de invocare
name va fi valoarea parametrului special shell 0 (vezi Secțiune 2.5.2, Special
parametrii) la momentul în care getopts utilitatea este invocată. Un nume echivalent cu:

nume de bază „0 $”

Poate fi folosit.

* Dacă se găsește o opțiune care nu a fost specificată în optstring, această eroare este identificată
iar caracterul de opțiune nevalid va fi identificat în mesaj.

* Dacă este găsită o opțiune care necesită un argument-opțiune, dar un argument-opțiune nu este găsit
găsită, această eroare va fi identificată și caracterul de opțiune nevalid va fi
identificate în mesaj.

REZULTATE DOSARE

Nici unul.

EXTENDED DESCRIERE

Nici unul.

EXIT STAREA

Următoarele valori de ieșire vor fi returnate:

0 O opțiune, specificată sau nespecificată de optstring, a fost găsit.

>0 S-a întâlnit sfârșitul opțiunilor sau a apărut o eroare.

CONSECINȚE OF ERORI

Implicit.

următor secțiuni sunt informativ.

APLICARE UTILIZARE

Întrucât getopts afectează mediul curent de execuție shell, acesta este în general furnizat ca
un shell obișnuit încorporat. Dacă este apelat într-un subshell sau într-o execuție de utilitate separată
mediu, cum ar fi unul dintre următoarele:

(getopts abc valoare „$@”)
nu getopts ...
găsi . −executiv getopts ... \;

nu afectează variabilele shell din mediul apelantului.

Rețineți că funcțiile shell partajează OPTIND cu shell-ul de chemare chiar dacă poziționalul
parametrii sunt modificați. Dacă shell-ul apelant și oricare dintre funcțiile sale utilizează getopts la
analiza argumentelor, rezultatele sunt nespecificate.

EXEMPLE

Următorul exemplu de script analizează și își afișează argumentele:

aflag=
bflag=
în timp ce getopts de la: nume
do
caz $nume in
a) aflag=1;;
b) bflag=1
bval="$OPTARG";;
?) printf „Utilizare: %s: [−a] [−b valoare] argumente\n" $0
ieşire 2;;
ESAC
făcut
if [ ! −z "$aflag" ]; apoi
printf "Opțiune −a specificat\n"
fi
if [ ! −z „$bflag” ]; apoi
printf 'Opțiune −b „%s” specificat\n' "$bval"
fi
schimbare $(($OPTIND - 1)))
printf "Rămas argumente sunt: %s\n$*"

FUNDAMENTARE

getopts utilitatea a fost aleasă în locul sistemului V getopt utilitate deoarece
getopts se ocupă de opțiuni-argumente care conțin personaje.

OPTARG variabila nu este menționată în secțiunea VARIABILE DE MEDIU deoarece da
nu afectează executarea getopts; este una dintre puținele variabile „doar ieșire” utilizate
de utilitățile standard.

The nu este permis ca caracter opțional, deoarece acesta nu este un comportament istoric,
și încalcă Regulile privind sintaxa utilitarului. The acum este specificat să se comporte ca
în versiunea KornShell a getopts utilitate; atunci când este folosit ca prim caracter în
optstring operand, dezactivează diagnosticarea privind opțiunile-argumente lipsă și
caractere de opțiune neașteptate. Aceasta înlocuiește utilizarea OPTERR variabilă care a fost
specificat într-o propunere timpurie.

Formatele mesajelor de diagnostic produse de getopts utilitatea și cel getopt()
funcția nu sunt complet specificate deoarece implementările cu superior (``mai prietenos'')
formatele au obiectat la formatele folosite de unele implementări istorice. Standardul
dezvoltatorii au considerat important ca informațiile din mesajele utilizate să fie uniforme
între getopts și getopt(). Dublarea exactă a mesajelor ar putea să nu fie posibilă,
mai ales dacă un utilitar este construit pe un alt sistem care are un alt sistem getopt()
funcția, dar mesajele trebuie să aibă informații specifice incluse astfel încât programul
numele, caracterul de opțiune nevalid și tipul de eroare pot fi distinse de un utilizator.

Doar un program de aplicație rar interceptează a getopts mesaj de eroare standard și dorește
analiza-l. Prin urmare, implementările sunt libere să aleagă cele mai utilizabile mesaje pe care le pot
concepe. Următoarele formate sunt utilizate de multe implementări istorice:

„%s: ilegal opțiune −− %c\n", <program nume>, <opțiune caracter>

„%s: opțiunea necesită un argument −− %c\n”,program nume>, \
<opțiune caracter>

Cochilii istorice cu versiuni încorporate ale getopt() sau getopts au folosit diferite
formate, deseori nici măcar nu indică caracterul de opțiune găsit în eroare.

VIITOR INSTRUCTIUNI

Nici unul.

Utilizați getoptsposix online folosind serviciile onworks.net