getoptsposix - Online nel cloud

PROGRAMMA:

NOME

getopts: analizza le opzioni dell'utilità

SINOSSI

getopts opstring Nome [arg...]

DESCRIZIONE

I getopts l'utilità recupererà le opzioni e gli argomenti delle opzioni da un elenco di parametri.
Supporterà le Linee guida sulla sintassi dell'utilità da 3 a 10 incluse, descritte nella Base
Volume delle definizioni di POSIX.1‐2008, Sezione 12.2, Utilità Sintassi Linee Guida.

Ogni volta che viene invocato, il getopts l'utilità inserirà il valore dell'opzione successiva
la variabile di shell specificata da Nome operando e l'indice dell'argomento successivo
elaborato nella variabile di shell OTTIMIZZA. Ogni volta che viene invocata la shell, OTTIMIZZA deve essere
inizializzato a 1.

Quando l'opzione richiede un argomento-opzione, il file getopts l'utilità lo inserirà nel file
variabile di shell OPTARG. Se non è stata trovata alcuna opzione o se l'opzione trovata non è stata trovata
avere un argomento opzionale, OPTARG deve essere disinserito.

Se un carattere opzionale non è contenuto nel file opstring l'operando si trova dove è presente un'opzione
è previsto il carattere, la variabile di shell specificata da Nome sarà impostato su
segno> ('?') carattere. In questo caso, se il primo carattere in opstring è un
(':'), la variabile di shell OPTARG deve essere impostato sul carattere opzionale trovato, ma nessun output
deve essere scritto in base all'errore standard; altrimenti, la variabile di shell OPTARG sarà disattivato
e verrà scritto un messaggio diagnostico nell'errore standard. Questa condizione sarà
considerato un errore rilevato nel modo in cui gli argomenti sono stati presentati all'invocatore
applicazione, ma non deve costituire un errore getopts trattamento.

Se manca un argomento opzionale:

* Se il primo carattere di opstring è un , la variabile di shell specificata da Nome
sarà impostato su carattere e la variabile di shell OPTARG deve essere impostato su
il carattere opzionale trovato.

* Altrimenti, la variabile di shell specificata da Nome sarà impostato su
carattere, la variabile di shell OPTARG sarà disattivato e verrà visualizzato un messaggio diagnostico
scritto in errore standard. Questa condizione sarà considerata un errore rilevato
nel modo in cui sono stati presentati gli argomenti alla domanda invocante, ma non deve essere un
errore in getopts in lavorazione; un messaggio diagnostico deve essere scritto come indicato, ma il
lo stato di uscita sarà pari a zero.

Quando viene raggiunta la fine delle opzioni, il file getopts l'utilità uscirà con un valore restituito
maggiore di zero; la variabile di shell OTTIMIZZA sarà impostato sull'indice del primo
operando o il valore "$ #"+1 se non ci sono operandi; IL Nome la variabile deve essere impostata su
IL carattere. Uno qualsiasi dei seguenti elementi identificherà la fine delle opzioni: il
prima di tutto "--" argomento che non è un argomento-opzione, trovare un argomento che non è un
argomento-opzione e non inizia con a '-'o si è verificato un errore.

Le variabili di shell OTTIMIZZA ed OPTARG sarà locale per il chiamante di getopts e deve
non essere esportato per impostazione predefinita.

La variabile di shell specificata da Nome operando, OTTIMIZZAe OPTARG influenzerà il
ambiente di esecuzione della shell corrente; Vedere Sezione 2.12, Conchiglia Ambiente.

Se l'applicazione viene impostata OTTIMIZZA al valore 1 è possibile utilizzare un nuovo set di parametri: o
i parametri posizionali attuali o nuovi arg valori. Qualsiasi altro tentativo di invocare getopts
più volte in un unico ambiente di esecuzione della shell con parametri (positional
parametri o arg operandi) che non sono gli stessi in tutte le invocazioni, o con an OTTIMIZZA
valore modificato per essere un valore diverso da 1, produce risultati non specificati.

VERSIONI

Nessuno.

OPERANDI

Devono essere supportati i seguenti operandi:

opstring Una stringa contenente i caratteri dell'opzione riconosciuti dall'utilità richiamata
getopts. Se un carattere è seguito da a , l'opzione è prevista
avere un argomento, che dovrebbe essere fornito come argomento separato.
Le applicazioni dovrebbero specificare un carattere di opzione e il relativo argomento di opzione come
argomenti separati, ma getopts interpreterà i caratteri che seguono un
carattere opzionale che richiede argomenti come argomento indipendentemente dal fatto che ciò venga fatto o meno.
Non è necessario che un argomento-opzione nullo esplicito venga riconosciuto se non viene fornito come
un argomento separato quando getopts viene invocato. (Vedi anche il ottenere() funzione
definito nel volume System Interfaces di POSIX.1‐2008.) I caratteri
E non devono essere utilizzati come caratteri opzionali da an
applicazione. L'uso di altri caratteri opzionali che non siano alfanumerici
produce risultati non specificati. Se l'argomento opzionale non viene fornito come a
argomento separato dal carattere dell'opzione, il valore in OPTARG deve essere
privato del carattere opzionale e del file '-'. Il primo carattere in opstring
determina come getopts si comporta se un carattere di opzione non è noto o un'opzione-
manca l'argomento.

Nome Il nome di una variabile di shell che verrà impostata da getopts utilità per il
carattere opzionale trovato.

I getopts l'utility per impostazione predefinita analizzerà i parametri posizionali passati all'invocante
procedura di shell. Se args vengono forniti, devono essere analizzati al posto del posizionale
parametri.

STDIN

Non usato.

INGRESSO FILE

Nessuno.

AMBIENTE VARIABILI

Le seguenti variabili d'ambiente influiranno sull'esecuzione di getopts:

LUNGO Fornire un valore predefinito per le variabili di internazionalizzazione non impostate o
nullo. (Vedi il volume Definizioni di base di POSIX.1-2008, Sezione 8.2,
Internazionalizzazione Variabili per il primato dell'internazionalizzazione
variabili utilizzate per determinare i valori delle categorie locali.)

LC_TUTTI Se impostato su un valore di stringa non vuoto, sovrascrive i valori di tutti gli altri
variabili di internazionalizzazione.

LC_CTYPE Determinare la localizzazione per l'interpretazione di sequenze di byte di dati di testo
come caratteri (ad esempio, caratteri a byte singolo anziché caratteri multibyte in
argomenti e file di input).

LC_MESSAGGI
Determinare la localizzazione che dovrebbe essere usata per influenzare il formato e il contenuto di
messaggi di diagnostica scritti nell'errore standard.

NLSPATH Determinare la posizione dei cataloghi dei messaggi per l'elaborazione di LC_MESSAGGI.

OTTIMIZZA Questa variabile sarà utilizzata da getopts utilità come indice del successivo
argomento da elaborare.

ASINCRONO EVENTI

Predefinito.

STDOUT

Non usato.

Stderr

Ogni volta che viene rilevato un errore e il primo carattere nel opstring l'operando non è un
(':'), deve essere scritto un messaggio diagnostico nell'errore standard con quanto segue
informazioni in un formato non specificato:

* Il nome del programma richiamato dovrà essere identificato nel messaggio. Il programma invocante
name deve essere il valore del parametro speciale della shell 0 (vedi Sezione 2.5.2, Special
parametri) all'epoca il getopts viene invocata l'utilità. Un nome equivalente a:

nome di base "$ 0"

può essere usato.

* Se viene trovata un'opzione che non è stata specificata in opstring, questo errore viene identificato
e il carattere dell'opzione non valida deve essere identificato nel messaggio.

* Se viene trovata un'opzione che richiede un argomento-opzione, ma un argomento-opzione no
trovato, questo errore sarà identificato e il carattere dell'opzione non valida sarà
identificato nel messaggio.

USCITA FILE

Nessuno.

EXTENDED DESCRIZIONE

Nessuno.

EXIT STATUS

Devono essere restituiti i seguenti valori di uscita:

0 Un'opzione, specificata o non specificata da opstring, è stato trovato.

>0 È stata rilevata la fine delle opzioni o si è verificato un errore.

CONSEGUENZE OF ERRORI

Predefinito.

I i seguenti sezioni sono Informativo.

APPLICAZIONI USO

Dal getopts influenza l'ambiente di esecuzione della shell corrente, è generalmente fornito come
un built-in regolare della shell. Se viene chiamato in una subshell o in un'esecuzione di utilità separata
ambiente, come uno dei seguenti:

(getopts abc APPREZZIAMO "$@")
no getopts ...
Find . − es getopts ... \;

non influisce sulle variabili di shell nell'ambiente del chiamante.

Tieni presente che le funzioni della shell condividono OTTIMIZZA con la shell chiamante anche se posizionale
i parametri vengono modificati. Se la shell chiamante e una qualsiasi delle sue funzioni utilizzano getopts a
analizzare gli argomenti, i risultati non sono specificati.

ESEMPI

Il seguente script di esempio analizza e visualizza i suoi argomenti:

in bandiera=
bflag=
while getopts da: Nome
do
Custodie $nome in
a) flag=1;;
b) bflag=1
bval="$OPTARG";;
?) printf "Utilizzo: %S: [-a] [−b valore] argomenti\n" $0
exit 2;;
che C
fatto
if [ ! -z "$bandiera" ]; poi
printf "Opzione -a specificato\n"
fi
if [ ! -z "$bflag" ]; poi
printf 'Opzione -b "%S" specificato\n' "$bval"
fi
spostamento $(($OTTIMIZZA - 1))
printf "Residuo argomenti siamo: %s\n$*"

FONDAMENTO LOGICO

I getopts l'utilità è stata scelta preferendola al System V ottenere utilità perché
getopts gestisce gli argomenti-opzione contenenti caratteri.

I OPTARG La variabile non è menzionata nella sezione VARIABILI D'AMBIENTE perché lo fa
non pregiudicare l'esecuzione di getopts; è una delle poche variabili "solo output" utilizzate
dalle utilità standard.

IL non è consentito come carattere opzionale perché non si tratta di un comportamento storico,
e viola le Linee guida sulla sintassi dell'utilità. IL è ora specificato di comportarsi come
nella versione KornShell del getopts utilità; quando utilizzato come primo carattere nel file
opstring operando, disabilita la diagnostica relativa agli argomenti delle opzioni mancanti e
caratteri di opzioni imprevisti. Questo sostituisce l'uso del file OPTERRA variabile che era
specificato in una prima proposta.

I formati dei messaggi diagnostici prodotti dal getopts utilità e il ottenere()
funzione non sono completamente specificate perché implementazioni con caratteristiche superiori (``più amichevoli'')
formati si sono opposti ai formati utilizzati da alcune implementazioni storiche. Lo standard
gli sviluppatori hanno ritenuto importante che le informazioni nei messaggi utilizzati fossero uniformi
fra getopts ed ottenere(). La duplicazione esatta dei messaggi potrebbe non essere possibile,
in particolare se un'utilità è creata su un altro sistema che ne ha uno diverso ottenere()
funzione, ma i messaggi devono includere informazioni specifiche affinché il programma
nome, carattere di opzione non valido e tipo di errore possono essere distinti da un utente.

Solo un raro programma applicativo intercetta a getopts messaggio di errore standard e lo desidera
analizzarlo. Pertanto, le implementazioni sono libere di scegliere i messaggi più utilizzabili possibile
ideare. I seguenti formati sono utilizzati da molte implementazioni storiche:

"%S: illegale opzione −− %c\n", <Programma Nome>, <opzione carattere>

"%s: l'opzione richiede un argomento −− %c\n",Programma Nome>, \
<opzione carattere>

Shell storiche con versioni integrate di ottenere() o getopts hanno usato diversi
formati, spesso senza nemmeno indicare il carattere dell'opzione trovato nell'errore.

FUTURE INDICAZIONI

Nessuno.

Utilizza getoptsposix online utilizzando i servizi onworks.net