getoptsposix - Online in de cloud

PROGRAMMA:

NAAM

getopts - ontleed hulpprogramma-opties

KORTE INHOUD

getopt optstring naam [arg...]

PRODUCTBESCHRIJVING

De getopt hulpprogramma haalt opties en optieargumenten op uit een lijst met parameters.
Het ondersteunt de Utility Syntax Guidelines 3 tot en met 10, beschreven in de Base
Definities volume van POSIX.1‐2008, sectie 12.2, utility Syntaxis Richtlijnen.

Elke keer dat het wordt aangeroepen, de getopt utility zal de waarde van de volgende optie erin plaatsen
de shell-variabele gespecificeerd door de naam operand en de index van het volgende te zijn argument
verwerkt in de shell-variabele OPTIND. Telkens wanneer de shell wordt aangeroepen, OPTIND zal zijn
geïnitialiseerd op 1.

Wanneer de optie een optie-argument vereist, de getopt hulpprogramma plaatst het in de
shell-variabele OPTARG. Als er geen optie is gevonden, of als de gevonden optie dat niet doet
een optie-argument hebben, OPTARG zal worden uitgeschakeld.

Als een optieteken niet in de optstring operand wordt gevonden waar een optie
karakter wordt verwacht, de shell-variabele gespecificeerd door naam wordt ingesteld op de
markeren> ('?') karakter. In dit geval, als het eerste teken in optstring is een
(':'), de shell-variabele OPTARG wordt ingesteld op het gevonden optieteken, maar geen uitvoer
zal naar standaardfout worden geschreven; anders de shell-variabele OPTARG zal worden uitgeschakeld
en een diagnostisch bericht zal naar standaardfout worden geschreven. Deze voorwaarde zal zijn
beschouwd als een fout die is ontdekt in de manier waarop argumenten aan de aanroepende partij werden gepresenteerd
toepassing, maar mag geen fout zijn in getopt processing.

Als een optie-argument ontbreekt:

* Als het eerste teken van optstring is een , de shell-variabele gespecificeerd door naam
wordt ingesteld op de karakter en de shell-variabele OPTARG wordt ingesteld op
het gevonden optieteken.

* Anders wordt de shell-variabele gespecificeerd door naam wordt ingesteld op de
karakter, de shell-variabele OPTARG wordt uitgeschakeld en er wordt een diagnostisch bericht weergegeven
geschreven naar standaardfout. Deze toestand wordt beschouwd als een gedetecteerde fout
in de manier waarop argumenten werden gepresenteerd aan het inroepende verzoekschrift, maar zal geen
fout in getopt verwerken; een diagnostisch bericht zal worden geschreven zoals vermeld, maar de
exitstatus is nul.

Wanneer het einde van de opties is bereikt, wordt de getopt hulpprogramma wordt afgesloten met een retourwaarde
groter dan nul; de shell-variabele OPTIND worden ingesteld op de index van de eerste
operand of de waarde '$ #'+1 als er geen operanden zijn; de naam variabele moet worden ingesteld op
de karakter. Een van de volgende zaken zal het einde van de opties aangeven: de
eerste "--" argument dat geen optie-argument is, een argument vinden dat geen
optie-argument en begint niet met een a '−', of er treedt een fout op.

De shell-variabelen OPTIND en OPTARG zal lokaal zijn voor de beller van getopt en zal
niet standaard worden geëxporteerd.

De shell-variabele gespecificeerd door de naam operand, OPTIND en OPTARG heeft invloed op de
huidige shell-uitvoeringsomgeving; zien sectie 2.12, Shell Uitvoering Milieu.

Als de toepassing wordt ingesteld OPTIND naar de waarde 1 kan een nieuwe set parameters worden gebruikt: ofwel
de huidige positionele parameters of nieuw arg waarden. Elke andere poging om aan te roepen getopt
meerdere keren in een enkele shell-uitvoeringsomgeving met parameters (positional
parameters of arg operanden) die niet hetzelfde zijn in alle aanroepen, of met een OPTIND
waarde gewijzigd in een andere waarde dan 1, levert niet-gespecificeerde resultaten op.

OPTIES

Geen.

OPERANDEN

De volgende operanden worden ondersteund:

optstring Een tekenreeks die de optietekens bevat die worden herkend door het aanroepende hulpprogramma
getopt. Als een teken wordt gevolgd door een , wordt de optie verwacht
een argument hebben, dat als een afzonderlijk argument moet worden opgegeven.
Toepassingen moeten een optieteken en het bijbehorende optieargument specificeren als
afzonderlijke argumenten, maar getopt interpreteert de tekens die volgen op een
optieteken dat argumenten als argument vereist, of dit nu wel of niet wordt gedaan.
Een expliciet null-optieargument hoeft niet te worden herkend als het niet wordt geleverd als
een apart argument wanneer getopt wordt ingeroepen. (Zie ook de opt() functie
gedefinieerd in het System Interfaces-volume van POSIX.1-2008.) De karakters
En mag niet worden gebruikt als optietekens door een
sollicitatie. Het gebruik van andere optietekens die niet alfanumeriek zijn
levert niet-gespecificeerde resultaten op. Als het optie-argument niet als a
scheid het argument van het optieteken, de waarde in OPTARG zal zijn
ontdaan van het optieteken en de '−'. Het eerste personage erin optstring
bepaalt hoe getopt gedraagt ​​zich als een optieteken niet bekend is of een optie-
betoog ontbreekt.

naam De naam van een shell-variabele die wordt ingesteld door de getopt nut aan de
optieteken dat is gevonden.

De getopt hulpprogramma analyseert standaard positionele parameters die worden doorgegeven aan het aanroepen
shell-procedure. Als args worden gegeven, zullen ze worden geparseerd in plaats van de positionele
parameters.

STDIN

Niet gebruikt.

INVOER FILES

Geen.

MILIEU VARIABELEN

De volgende omgevingsvariabelen zijn van invloed op de uitvoering van: getopt:

TAAL Geef een standaardwaarde op voor de internationaliseringsvariabelen die niet zijn ingesteld of
nul. (Zie het volume Basisdefinities van POSIX.1‐2008, sectie 8.2,
internationalisering Variabelen voor de prioriteit van internationalisering
variabelen die worden gebruikt om de waarden van landinstellingen te bepalen.)

LC_ALL Indien ingesteld op een niet-lege tekenreekswaarde, overschrijf dan de waarden van alle andere
internationaliseringsvariabelen.

LC_CTYPE Bepaal de landinstelling voor de interpretatie van reeksen bytes tekstgegevens
als tekens (bijvoorbeeld single-byte in plaats van multi-byte tekens in
argumenten en invoerbestanden).

LC_MESSAGES
Bepaal de landinstelling die moet worden gebruikt om het formaat en de inhoud van te beïnvloeden
diagnostische berichten geschreven naar standaardfout.

NLSPAT Bepaal de locatie van berichtencatalogi voor de verwerking van: LC_MESSAGES.

OPTIND Deze variabele wordt gebruikt door de getopt hulpprogramma als de index van de volgende
argument te verwerken.

ASYNCHROON EVENEMENTEN

Standaard.

STDOUT

Niet gebruikt.

STDERR

Telkens wanneer een fout wordt gedetecteerd en het eerste teken in het optstring operand is geen
(':'), zal een diagnostisch bericht worden geschreven naar de standaardfout met het volgende
informatie in een niet-gespecificeerd formaat:

* De naam van het oproepende programma wordt in het bericht vermeld. Het aanroepende programma
naam zal de waarde zijn van de shell speciale parameter 0 (zie sectie 2.5.2, special
parameters) op het moment dat de getopt hulpprogramma wordt aangeroepen. Een naam gelijk aan:

basisnaam '$ 0'

mag gebruikt worden.

* Als een optie wordt gevonden die niet is opgegeven in optstring, wordt deze fout geïdentificeerd
en het ongeldige optieteken zal in het bericht worden geïdentificeerd.

* Als een optie wordt gevonden die een optieargument vereist, maar een optieargument niet
gevonden, wordt deze fout geïdentificeerd en wordt het ongeldige optieteken weergegeven
geïdentificeerd in het bericht.

OUTPUT FILES

Geen.

UITGEBREID PRODUCTBESCHRIJVING

Geen.

EXIT STATUS

De volgende exit-waarden worden geretourneerd:

0 Een optie, gespecificeerd of niet gespecificeerd door optstring, was gevonden.

>0 Het einde van de opties is bereikt of er is een fout opgetreden.

GEVOLGEN OF FOUTEN

Standaard.

De volgend secties zijn informatief.

TOEPASSING GEBRUIK

Sinds getopt beïnvloedt de huidige shell-uitvoeringsomgeving, het wordt over het algemeen geleverd als
een gewone shell ingebouwd. Als het wordt aangeroepen in een subshell of een afzonderlijke uitvoering van het hulpprogramma
omgeving, zoals een van de volgende:

(getopt abc waarde "$@")
nee getopt ...
vinden . exec getopt ... \;

het heeft geen invloed op de shell-variabelen in de omgeving van de beller.

Merk op dat shell-functies delen OPTIND met de aanroepende shell, hoewel de positionele
parameters worden gewijzigd. Als de aanroepende shell en een van zijn functies gebruikt getopt naar
parse-argumenten, de resultaten zijn niet gespecificeerd.

Voorbeelden

Het volgende voorbeeldscript analyseert en geeft de argumenten weer:

vlag=
bvlag=
en getopt uit: naam
do
geval name $ in
a) vlag=1;;
b) bvlag=1
bval="$OPTARG";;
?) printf "Gebruik: % s: [-a] [-b waarde] argumenten\n" $0
afrit 2 ;;
hexac
gedaan
if [ ! z "$vlag" ]; harte
printf "Keuze a gespecificeerd\n"
fi
if [ ! z "$bvlag" ]; harte
printf 'Keuze b "%s" gespecificeerd\n' "$bval"
fi
verschuiving $(($OPTIND - 1))
printf "Overig argumenten zijn: %s\n$*"

BEWEEGREDENEN

De getopt hulpprogramma werd gekozen in plaats van System V opt nut omdat
getopt behandelt optie-argumenten met karakters.

De OPTARG variabele wordt niet vermeld in de sectie OMGEVINGSVARIABELEN omdat dit wel het geval is
geen invloed op de uitvoering van getopt; het is een van de weinige ``output-only'' variabelen die gebruikt worden
door de standaard hulpprogramma's.

De is niet toegestaan ​​als optiekarakter omdat dat geen historisch gedrag is,
en het is in strijd met de richtlijnen voor syntaxis van hulpprogramma's. De is nu gespecificeerd om zich te gedragen als
in de KornShell-versie van de getopt nutsvoorziening; wanneer gebruikt als het eerste teken in de
optstring operand, het schakelt diagnostiek uit met betrekking tot ontbrekende optie-argumenten en
onverwachte optiekarakters. Dit vervangt het gebruik van de OPTERR variabele dat was
gespecificeerd in een vroeg voorstel.

De formaten van de diagnostische berichten geproduceerd door de getopt hulpprogramma en de opt()
functies zijn niet volledig gespecificeerd omdat implementaties met superieure (``vriendelijkere'')
formaten maakten bezwaar tegen de formaten die door sommige historische implementaties werden gebruikt. De standaard
ontwikkelaars vonden het belangrijk dat de informatie in de gebruikte berichten uniform was
tussen getopt en opt(). Exact dupliceren van de berichten is misschien niet mogelijk,
vooral als een hulpprogramma is gebouwd op een ander systeem dat een ander systeem heeft opt()
functie, maar de berichten moeten specifieke informatie bevatten, zodat het programma
naam, ongeldig optieteken en type fout kunnen door een gebruiker worden onderscheiden.

Slechts een zeldzaam toepassingsprogramma onderschept een getopt standaard foutmelding en wil
ontleed het. Daarom zijn implementaties vrij om de meest bruikbare berichten te kiezen
bedenken. De volgende formaten worden door veel historische implementaties gebruikt:

"%s: onwettig optie - %c\n", <programma naam>, <optie karakter>

"%s: optie vereist een argument −− %c\n",programma naam>, \
<optie karakter>

Historische shells met ingebouwde versies van opt() of getopt hebben verschillende gebruikt
formaten, waarbij vaak niet eens het foutief gevonden optieteken wordt aangegeven.

TOEKOMST ROUTEBESCHRIJVING

Geen.

Gebruik getoptsposix online met behulp van onworks.net-services