Ritorno implicito nelle funzioni bash?

Supponiamo che io abbia una funzione bash in questo modo:

gmx(){
  echo "foo";
}

questa funzione restituirà implicitamente il valore di uscita del echocomando o è necessario utilizzare return?

gmx(){
  echo "foo";
  return $?
}

Suppongo che il modo in cui bash funziona, lo stato di uscita del comando finale della funzione bash sia quello che viene "restituito", ma non certo al 100%.

returnesegue un ritorno esplicito da una funzione shell o "dot script" (uno script di provenienza). Se returnnon viene eseguito, viene restituito un ritorno implicito alla fine della funzione di shell o del punto script.

Se returnviene eseguito senza un parametro, equivale a restituire lo stato di uscita del comando eseguito più di recente.

Ecco come returnfunziona in tutte le shell POSIX.

Per esempio,

gmx () {
  echo 'foo'
  return "$?"
}

è quindi equivalente a

gmx () {
  echo 'foo'
  return
}

che è lo stesso di

gmx () {
  echo 'foo'
}

In generale, è molto raro che tu debba usarlo $?affatto. È davvero necessario solo se è necessario salvarlo per un uso futuro, ad esempio se è necessario studiarne il valore più volte (nel qual caso si assegnerebbe il valore a una variabile ed eseguirà una serie di test su quella variabile).

Dalla bash(1)pagina man:

Quando eseguito, lo stato di uscita di una funzione è lo stato di uscita dell'ultimo comando eseguito nel corpo.

Aggiungerò solo alcune note di cautela alle risposte già fornite:

• Anche se returnha un significato molto speciale per la shell, dal punto di vista della sintassi, è un comando incorporato della shell e un'istruzione return viene analizzata come qualsiasi altro comando semplice. Quindi, ciò significa che come nell'argomento di qualsiasi altro comando, $?quando non quotato, sarebbe soggetto a split + glob

  Quindi è necessario citare questo $?per evitarlo:

  return "$?"

• returndi solito non accetta alcuna opzione ( ksh93's accetta il solito --help, --man, --author... però). L'unico argomento che si aspetta (facoltativo) è il codice di ritorno. L'intervallo dei codici di ritorno accettati varia da shell a shell e se qualsiasi valore esterno a 0..255 viene correttamente riflesso $?varia anche da shell a shell. Vedi Codice di uscita predefinito al termine del processo? per dettagli al riguardo.

  La maggior parte delle shell accetta numeri negativi (dopo tutto, l'argomento passato alla chiamata _exit()/ exitgroup()system è un int, quindi con valori che comprendono almeno -2 ³¹ a 2 ³¹ -1, quindi ha senso solo che le shell accettino lo stesso intervallo per le sue funzioni) .

  La maggior parte delle shell usa waitpid()e. API per recuperare che lo stato di uscita tuttavia in questo caso, è troncato a un numero compreso tra 0 e 255 quando immagazzinato in $?. Anche se invocare una funzione non comporta la generazione di un processo e utilizzato waitpid()per recuperare il suo stato di uscita poiché tutto viene eseguito nello stesso processo, molte shell imitano anche quel waitpid()comportamento quando si invocano funzioni. Ciò significa che anche se chiami returncon un valore negativo, $?conterrà un numero positivo.

  Ora, tra quelle shell che returnaccettano numeri negativi (ksh88, ksh93, bash, zsh, pdksh e derivati ​​diversi da mksh, yash), ce ne sono alcuni (pdksh e yash) che ne hanno bisogno scritto return -- -123come altrimenti che -123è preso come tre -1, -2, -3opzioni non valide.

  Dato che pdksh e i suoi derivati ​​(come OpenBSD sho posh) conservano il numero negativo in $?, ciò significa che return "$?"farebbe fallire quando $?contiene un numero negativo (cosa che accadrebbe quando l'ultimo comando eseguito fosse una funzione che restituiva un numero negativo).

  Quindi return -- "$?"sarebbe meglio in quelle conchiglie. Si noti tuttavia che mentre è supportato dalla maggior parte delle shell, quella sintassi non è POSIX e in pratica non è supportata da mkshe derivati ​​di cenere.

  Quindi, per riassumere, con shell basate su pdksh, puoi usare numeri negativi negli argomenti per le funzioni, ma se lo fai, return "$@"non funzionerà. In altre shell return "$@"funzionerà e dovresti evitare di usare numeri negativi (o numeri al di fuori di 0..255) come argomenti per return.

• In tutte le shell che conosco, la chiamata returndall'interno di una subshell in esecuzione all'interno di una funzione causerà l'uscita della subshell (con lo stato di uscita fornito se presente o quello dell'ultimo comando eseguito), ma non provocherà altrimenti un ritorno dalla funzione ( per me, non è chiaro se POSIX ti offra tale garanzia, alcuni sostengono che exitdovrebbe essere usato al posto delle uscite secondarie all'interno delle funzioni). Per esempio

  f() {
    (return 3)
    echo "still inside f. Exit status: $?"
  }
  f
  echo "f exit status: $?"
  

  produrrà:

  still inside f. Exit status: 3
  f exit status: 0
  

Sì, il valore di ritorno implicito di una funzione è lo stato di uscita dell'ultimo comando eseguito . Questo è anche vero in qualsiasi punto di qualsiasi script di shell. In qualsiasi punto della sequenza di esecuzione dello script, lo stato di uscita attuale è lo stato di uscita dell'ultimo comando eseguito. Anche comando eseguito come parte di un'assegnazione di variabile: var=$(exit 34). La differenza con le funzioni è che una funzione potrebbe cambiare lo stato di uscita al termine dell'esecuzione della funzione.

Il modo alternativo di modificare lo "stato di uscita attuale" è quello di avviare una shell secondaria ed uscire con lo stato di uscita necessario:

$ $(exit 34)
$ echo "$?"
34

E sì, l' espansione dello stato di uscita deve essere quotata:

$ IFS='123'
$ $(exit 34)
$ echo $?
4

Un (exit 34)lavoro anche.
Alcuni potrebbero obiettare che dovrebbe essere un costrutto più robusto $(return 34)e che un'uscita dovrebbe "uscire" dallo script in esecuzione. Ma $(return 34)non funziona con nessuna versione di bash. Quindi, non è portatile.

Il modo più sicuro per impostare uno stato di uscita è usarlo come è stato progettato per funzionare, definire e returnda una funzione:

exitstatus(){ return "${1:-"$?"}"; }

Quindi, alla fine di una funzione. è esattamente equivalente a non avere nulla o returnoppure return "$?". La fine di una funzione non deve necessariamente significare "l'ultima riga di codice di una funzione".

#!/bin/sh
exitstatus(){ a="${1:-"$?"}"; return "$a"; }
gmx(){
    if     [ "$1" = "one" ]; then
           printf 'foo ';
           exitstatus 78
           return "$?"
    elif   [ "$1" = "two" ]; then
           printf 'baz ';
           exitstatus 89
           return
    else
           printf 'baz ';
           exitstatus 90
    fi
}  

Stampa:

$ ./script
foo 78
baz 89
baz 90

L'unico uso pratico per "$?"è stampare il suo valore: echo "$?"o memorizzarlo in una variabile (in quanto è un valore effimero e cambiare ad ogni comando eseguito): exitstatus=$?(ricordati di citare la variabile in comandi come export EXITSTATUS="$?".

Nel returncomando, l'intervallo di valori valido è generalmente compreso tra 0 e 255, ma è necessario comprendere che i valori di 126 + nvengono utilizzati da alcune shell per segnalare uno stato di uscita speciale, quindi la raccomandazione generale è di utilizzare 0-125.