getoptsposix – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

getopts – Parse-Dienstprogrammoptionen

ZUSAMMENFASSUNG

Getopte optstring Name [arg...]

BESCHREIBUNG

Das Getopte Das Dienstprogramm soll Optionen und Optionsargumente aus einer Liste von Parametern abrufen.
Es muss die in der Basis beschriebenen Utility-Syntax-Richtlinien 3 bis 10 unterstützen
Definitionen Band von POSIX.1‐2008, Abschnitt 12.2, Dienstprogramm Syntax Richtlinien.

Bei jedem Aufruf wird die Getopte Das Dienstprogramm legt den Wert der nächsten Option fest
die von der angegebene Shell-Variable Name Operand und der Index des nächsten Arguments
in der Shell-Variable verarbeitet Opt. Immer wenn die Shell aufgerufen wird, Opt sind
initialisiert auf 1.

Wenn die Option ein Optionsargument erfordert, wird die Getopte Das Versorgungsunternehmen legt es in die
Shell-Variable OPTARG. Wenn keine Option gefunden wurde oder die gefundene Option nicht gefunden wurde
ein Optionsargument haben, OPTARG soll deaktiviert sein.

Wenn ein Optionszeichen nicht in der enthalten ist optstring Der Operand wird dort gefunden, wo eine Option vorhanden ist
Zeichen wird erwartet, die von angegebene Shell-Variable Name soll auf eingestellt werden
markieren> ('?') Charakter. In diesem Fall, wenn das erste Zeichen in optstring ist ein
(':'), die Shell-Variable OPTARG soll auf das gefundene Optionszeichen gesetzt werden, aber keine Ausgabe
wird im Standardfehler geschrieben; andernfalls die Shell-Variable OPTARG soll deaktiviert sein
und eine Diagnosemeldung soll in den Standardfehler geschrieben werden. Diese Bedingung muss erfüllt sein
Dies wird als Fehler angesehen, der in der Art und Weise festgestellt wurde, wie dem Aufrufenden Argumente vorgelegt wurden
Anwendung, darf aber kein Fehler sein Getopte Verarbeitung.

Wenn ein Optionsargument fehlt:

* Wenn das erste Zeichen von optstring ist ein , die von angegebene Shell-Variable Name
soll auf eingestellt werden Zeichen und die Shell-Variable OPTARG eingestellt werden soll
das gefundene Optionszeichen.

* Ansonsten die von angegebene Shell-Variable Name soll auf eingestellt werden
Zeichen, die Shell-Variable OPTARG muss deaktiviert sein und eine Diagnosemeldung muss deaktiviert sein
in den Standardfehler geschrieben. Dieser Zustand gilt als erkannter Fehler
in der Art und Weise, wie Argumente gegenüber dem berufenden Antrag vorgebracht wurden, ist jedoch kein
Fehler in Getopte wird bearbeitet; Eine Diagnosemeldung soll wie angegeben geschrieben werden, aber die
Der Exit-Status muss Null sein.

Wenn das Ende der Optionen erreicht ist, wird die Getopte Das Dienstprogramm wird mit einem Rückgabewert beendet
größer als Null; die Shell-Variable Opt wird auf den Index des ersten gesetzt
Operand oder der Wert "$ #"+1, wenn keine Operanden vorhanden sind; Die Name Variable soll auf gesetzt werden
Die Charakter. Das Ende der Optionen muss durch eines der folgenden Elemente gekennzeichnet werden: das
zuerst "−−" Argument, das kein Optionsargument ist, Finden eines Arguments, das kein Optionsargument ist
Optionsargument und beginnt nicht mit a '-'oder es ist ein Fehler aufgetreten.

Die Shell-Variablen Opt und OPTARG muss lokal für den Anrufer von sein Getopte und soll
nicht standardmäßig exportiert werden.

Die von angegebene Shell-Variable Name Operand, Opt und OPTARG soll sich auf die auswirken
aktuelle Shell-Ausführungsumgebung; sehen Abschnitt 2.12, Schale ausführung Arbeitsumfeld.

Wenn die Anwendung eingestellt ist Opt auf den Wert 1 kann ein neuer Parametersatz verwendet werden: entweder
die aktuellen Positionsparameter oder neue arg Werte. Jeder andere Aufrufversuch Getopte
mehrmals in einer einzigen Shell-Ausführungsumgebung mit Parametern (positional
Parameter oder arg Operanden), die nicht in allen Aufrufen gleich sind, oder mit einem Opt
Wenn der Wert auf einen anderen Wert als 1 geändert wird, führt dies zu nicht spezifizierten Ergebnissen.

OPTIONAL

Keiner.

OPERANDEN

Folgende Operanden sollen unterstützt werden:

optstring Eine Zeichenfolge, die die vom aufrufenden Dienstprogramm erkannten Optionszeichen enthält
Getopte. Wenn auf ein Zeichen ein folgt , die Option ist zu erwarten
ein Argument haben, das als separates Argument angegeben werden sollte.
Anwendungen sollten ein Optionszeichen und sein Optionsargument als angeben
separate Argumente, aber Getopte soll die Zeichen nach einem interpretieren
Optionszeichen, das Argumente als Argument erfordert, unabhängig davon, ob dies geschieht oder nicht.
Ein explizites Null-Optionsargument muss nicht erkannt werden, wenn es nicht als angegeben wird
ein separates Argument when Getopte aufgerufen wird. (Siehe auch die getopt() Funktion
definiert im System Interfaces-Band von POSIX.1-2008.) Die Zeichen
Und dürfen von an nicht als Optionszeichen verwendet werden
Anwendung. Die Verwendung anderer Optionszeichen, die nicht alphanumerisch sind
führt zu nicht spezifizierten Ergebnissen. Wenn das Optionsargument nicht als angegeben wird
Separates Argument vom Optionszeichen, der Wert in OPTARG sind
des Optionszeichens und der entfernt '-'. Das erste Zeichen in optstring
bestimmt wie Getopte verhält sich, wenn ein Optionszeichen nicht bekannt ist oder ein Optionszeichen
Argument fehlt.

Name Der Name einer Shell-Variablen, die von festgelegt werden soll Getopte Dienstprogramm für die
Optionszeichen, das gefunden wurde.

Das Getopte Das Dienstprogramm analysiert standardmäßig die Positionsparameter, die an den Aufrufer übergeben werden
Shell-Prozedur. Wenn args werden angegeben, sie sollen anstelle der Position analysiert werden
Parameter.

STDIN

Nicht benutzt.

SPEISUNG DATEIEN

Keiner.

VARIABLEN

Die folgenden Umgebungsvariablen sollen die Ausführung von Getopte:

SPRACHE Geben Sie einen Standardwert für die Internationalisierungsvariablen an, die nicht festgelegt sind oder
Null. (Siehe den Band Basisdefinitionen von POSIX.1‐2008, Abschnitt 8.2,
Internationalisierung Variablen für den Vorrang der Internationalisierung
Variablen, die verwendet werden, um die Werte von Gebietsschemakategorien zu bestimmen.)

LC_ALL Wenn auf einen nicht leeren Zeichenfolgenwert gesetzt, überschreiben Sie die Werte aller anderen
Internationalisierungsvariablen.

LC_CTYPE Bestimmen Sie das Gebietsschema für die Interpretation von Sequenzen von Bytes von Textdaten
als Zeichen (z. B. Einzelbyte- im Gegensatz zu Mehrbyte-Zeichen in
Argumente und Eingabedateien).

LC_MESSAGES
Bestimmen Sie das Gebietsschema, das verwendet werden soll, um das Format und den Inhalt von . zu beeinflussen
Diagnosemeldungen in Standardfehler geschrieben.

NLSPATH Bestimmen Sie den Speicherort von Nachrichtenkatalogen für die Verarbeitung von LC_MESSAGES.

Opt Diese Variable soll von verwendet werden Getopte Dienstprogramm als Index des nächsten
Argument, das verarbeitet werden soll.

ASYNCHRON Events

Standard.

STDOUT

Nicht benutzt.

STDERR

Immer wenn ein Fehler erkannt wird und das erste Zeichen in der optstring Operand ist kein
(':') muss eine Diagnosemeldung wie folgt in den Standardfehler geschrieben werden
Informationen in einem nicht spezifizierten Format:

* Der Name des aufrufenden Programms muss in der Nachricht angegeben werden. Das aufrufende Programm
Name muss der Wert des Shell-Spezialparameters 0 sein (siehe Abschnitt 2.5.2, Spezial
Parameter) zum Zeitpunkt der Getopte Das Dienstprogramm wird aufgerufen. Ein Name, der entspricht:

Basisname "$ 0"

könnte genutzt werden.

* Wenn eine Option gefunden wird, die nicht in angegeben wurde optstring, wird dieser Fehler identifiziert
und das ungültige Optionszeichen muss in der Nachricht identifiziert werden.

* Wenn eine Option gefunden wird, die ein Optionsargument erfordert, aber kein Optionsargument
gefunden, wird dieser Fehler identifiziert und das ungültige Optionszeichen gelöscht
in der Nachricht identifiziert.

AUSGABE DATEIEN

Keiner.

VERLÄNGERT BESCHREIBUNG

Keiner.

EXIT STATUS

Die folgenden Exit-Werte sollen zurückgegeben werden:

0 Eine Option, angegeben oder nicht angegeben von optstring, wurde gefunden.

>0 Das Ende der Optionen wurde festgestellt oder es ist ein Fehler aufgetreten.

FOLGEN OF FEHLER

Standard.

Das Folgende Abschnitte sind informativ.

Anmeldeformular ANWENDUNG

Da Getopte wirkt sich auf die aktuelle Shell-Ausführungsumgebung aus und wird im Allgemeinen als bereitgestellt
eine Shell regelmäßig eingebaut. Wenn es in einer Subshell oder einer separaten Dienstprogrammausführung aufgerufen wird
Umgebung, wie zum Beispiel eine der folgenden:

(getopt ABC Wert „$@“)
Nohup Getopte ...
gefunden . −exec Getopte ... \;

Es wirkt sich nicht auf die Shell-Variablen in der Umgebung des Aufrufers aus.

Beachten Sie, dass Shell-Funktionen gemeinsam genutzt werden Opt mit der aufrufenden Shell, obwohl die Position
Parameter geändert werden. Wenn die aufrufende Shell und eine ihrer Funktionen verwendet Getopte zu
Argumente analysieren, die Ergebnisse sind nicht spezifiziert.

Beispiele:

Das folgende Beispielskript analysiert seine Argumente und zeigt sie an:

aflag=
bflag=
während Getopte ab: Name
do
Häuser $ name in
a) aflag=1;;
b) bflag=1
bval="$OPTARG";;
?) printf "Verwendung: % s: [−a] [−b Wert] args\n" $0
wunsch 2 ;;
esac
erledigt
if [ ! − z „$aflag“ ]; dann
printf "Möglichkeit -a angegeben\n"
fi
if [ ! − z „$bflag“ ]; dann
printf 'Möglichkeit -b "%S" angegeben\n' „$bval“
fi
verschieben $(($OPTIND - 1))
printf "Übrig Argumente sind: %s\n$*"

RATIONALE

Das Getopte Das Dienstprogramm wurde dem System V vorgezogen getopt Dienstprogramm, weil
Getopte behandelt Optionsargumente, die enthalten Figuren.

Das OPTARG Die Variable wird im Abschnitt UMGEBUNGSVARIABLEN nicht erwähnt, da dies der Fall ist
keinen Einfluss auf die Ausführung Getopte; Es handelt sich um eine der wenigen verwendeten „Nur-Ausgabe“-Variablen
durch die Standard-Dienstprogramme.

Der ist als Optionszeichen nicht zulässig, da dies kein historisches Verhalten ist.
und es verstößt gegen die Utility-Syntaxrichtlinien. Der ist jetzt so angegeben, dass es sich wie folgt verhält
in der KornShell-Version von Getopte Dienstprogramm; wenn es als erstes Zeichen im verwendet wird
optstring Operanden deaktiviert die Diagnose bezüglich fehlender Optionsargumente und
unerwartete Optionszeichen. Dies ersetzt die Verwendung von OPTERR Variable, die war
in einem frühen Vorschlag festgelegt.

Die Formate der von der erzeugten Diagnosemeldungen Getopte Dienstprogramm und die getopt()
Funktionen sind nicht vollständig spezifiziert, da Implementierungen mit überlegenen („freundlicheren“)
Formate widersprachen den Formaten, die von einigen historischen Implementierungen verwendet wurden. Der Standard
Den Entwicklern war es wichtig, dass die Informationen in den verwendeten Nachrichten einheitlich sind
zwischen Getopte und getopt(). Eine exakte Vervielfältigung der Nachrichten ist möglicherweise nicht möglich.
insbesondere, wenn ein Dienstprogramm auf einem anderen System basiert, das über ein anderes System verfügt getopt()
Funktion, aber die Nachrichten müssen spezifische Informationen enthalten, damit das Programm
Name, ungültiges Optionszeichen und Art des Fehlers können vom Benutzer unterschieden werden.

Nur ein seltenes Anwendungsprogramm fängt a ab Getopte Standardfehlermeldung und möchte
Analysieren Sie es. Daher steht es den Implementierungen frei, die am besten verwendbaren Nachrichten auszuwählen
entwickeln. Die folgenden Formate werden von vielen historischen Implementierungen verwendet:

"%S: illegal zu erhalten −− %c\n", <Programm Name>, <zu erhalten Charakter>

„%s: Option erfordert ein Argument −− %c\n“,Programm Name>, \
<zu erhalten Charakter>

Historische Muscheln mit eingebauten Versionen von getopt() oder Getopte habe anders verwendet
Formate, wobei häufig nicht einmal das fehlerhaft gefundene Optionszeichen angegeben wird.

ZUKUNFT RICHTUNGEN

Keiner.

Nutzen Sie getoptsposix online über die Dienste von onworks.net