Exit e Return

exit status

Le funzioni restituiscono un valore, chiamato exit status. L'exit status può essere specificato in maniera esplicita con l'istruzione return, altrimenti corrisponde all'exit status dell'ultimo comando della funzione (0 in caso di successo, un codice d'errore diverso da zero in caso contrario). Questo exit status può essere usato nello script facendovi riferimento tramite $?. Questo meccanismo consente alle funzioni di avere un "valore di ritorno" simile a quello delle funzioni del C.

return

Termina una funzione. Il comando return [1] può avere opzionalmente come argomento un intero, che viene restituito allo script chiamante come "exit status" della funzione. Questo exit status viene assegnato alla variabile $?.

Esempio 23-7. Il maggiore di due numeri

#!/bin/bash # max.sh: Maggiore di due numeri. E_ERR_PARAM=-198 # Se vengono passati meno di 2 parametri alla funzione. UGUALI=-199 # Valore di ritorno se i due numeri sono uguali. # Errore per i valori fuori intervallo passati come parametri alla funzione. max2 () # Restituisce il maggiore di due numeri. { # Nota: i numeri confrontati devono essere minori di 257. if [ -z "$2" ] then return $E_ERR_PARAM fi if [ "$1" -eq "$2" ] then return $UGUALI else if [ "$1" -gt "$2" ] then return $1 else return $2 fi fi } max2 33 34 val_ritorno=$? if [ "$val_ritorno" -eq $E_ERR_PARAM ] then echo "Bisogna passare due parametri alla funzione." elif [ "$val_ritorno" -eq $UGUALI ] then echo "I due numeri sono uguali." else echo "Il maggiore dei due numeri è $val_ritorno." fi exit 0 # Esercizio (facile): # ------------------ # Trasformatelo in uno script interattivo, #+ cioè, deve essere lo script a richiedere l'input (i due numeri).

Per fare in modo che una funzione possa restituire una stringa o un array , si deve fare ricorso ad una variabile dedicata. conteggio_righe_di_etc_passwd() { [[ -r /etc/passwd ]] && REPLY=$(echo $(wc -l < /etc/passwd)) # Se /etc/passwd ha i permessi di lettura, imposta REPLY al #+ numero delle righe. # Restituisce o il valore del parametro o un'informazione di stato. # 'echo' sembrerebbe non necessario, ma . . . #+ rimuove dall'output gli spazi in eccesso. } if conteggio_righe_di_etc_passwd then echo "Ci sono $REPLY righe in /etc/passwd." else echo "Non posso contare le righe in /etc/passwd." fi # Grazie, S.C.

Esempio 23-8. Convertire i numeri arabi in numeri romani

#!/bin/bash # Conversione di numeri arabi in numeri romani # Intervallo: 0 - 200 # È rudimentale, ma funziona. # Viene lasciato come esercizio l'estensione dell'intervallo e #+ altri miglioramenti dello script. # Utilizzo: numero da convertire in numero romano LIMITE=200 E_ERR_ARG=65 E_FUORI_INTERVALLO=66 if [ -z "$1" ] then echo "Utilizzo: `basename $0` numero-da-convertire" exit $E_ERR_ARG fi num=$1 if [ "$num" -gt $LIMITE ] then echo "Fuori intervallo!" exit $E_FUORI_INTERVALLO fi calcola_romano () # Si deve dichiarare la funzione prima di richiamarla. { numero=$1 fattore=$2 c_romano=$3 let "resto = numero - fattore" while [ "$resto" -ge 0 ] do echo -n $c_romano let "numero -= fattore" let "resto = numero - fattore" done return $numero # Esercizio: # ---------- # Spiegate come opera la funzione. # Suggerimento: divisione per mezzo di sottrazioni successive. } calcola_romano $num 100 C num=$? calcola_romano $num 90 LXXXX num=$? calcola_romano $num 50 L num=$? calcola_romano $num 40 XL num=$? calcola_romano $num 10 X num=$? calcola_romano $num 9 IX num=$? calcola_romano $num 5 V num=$? calcola_romano $num 4 IV num=$? calcola_romano $num 1 I echo exit 0

Vedi anche Esempio 10-28.

Il più grande intero positivo che una funzione può restituire è 255. Il comando return è strettamente legato al concetto di exit status, e ciò è la causa di questa particolare limitazione. Fortunatamente, esistono diversi espedienti per quelle situazioni che richiedono un valore di ritorno della funzione maggiore di 255. Esempio 23-9. Verificare valori di ritorno di grandi dimensioni in una funzione #!/bin/bash # return-test.sh # Il maggiore valore positivo che una funzione può restituire è 255. val_ritorno () # Restituisce tutto quello che gli viene passato. { return $1 } val_ritorno 27 # o.k. echo $? # Restituisce 27. val_ritorno 255 # Ancora o.k. echo $? # Restituisce 255. val_ritorno 257 # Errore! echo $? # Restituisce 1 (codice d'errore generico). # ============================================================ val_ritorno -151896 # Funziona con grandi numeri negativi? echo $? # Restituirà -151896? # No! Viene restituito 168. # Le versioni di Bash precedenti alla 2.05b permettevano #+ valori di ritorno di grandi numeri negativi. # Quelle più recenti non consentono questa scappatoia. # Ciò potrebbe rendere malfunzionanti i vecchi script. # Attenzione! # ============================================================ exit 0 Un espediente per ottenere un intero di grandi dimensioni consiste semplicemente nell'assegnare il "valore di ritorno" ad una variabile globale. Val_Ritorno= # Variabile globale che contiene un valore di ritorno #+ della funzione maggiore di 255. ver_alt_ritorno () { fvar=$1 Val_Ritorno=$fvar return # Restituisce 0 (successo). } ver_alt_ritorno 1 echo $? # 0 echo "valore di ritorno = $Val_Ritorno" # 1 ver_alt_ritorno 256 echo "valore di ritorno = $Val_Ritorno" # 256 ver_alt_ritorno 257 echo "valore di ritorno = $Val_Ritorno" # 257 ver_alt_ritorno 25701 echo "valore di ritorno = $Val_Ritorno" # 25701 Un metodo anche più elegante consiste nel visualizzare allo stdout il "valore di ritorno" della funzione con il comando echo e poi "catturarlo" per mezzo della sostituzione di comando. Per una discussione sull'argomento vedi la Sezione 33.7. Esempio 23-10. Confronto di due interi di grandi dimensioni #!/bin/bash # max2.sh: Maggiore di due GRANDI interi. # È il precedente esempio "max.sh" , #+ modificato per consentire il confronto di grandi numeri. UGUALI=0 # Valore di ritorno se i due parametri sono uguali. E_ERR_PARAM=-99999 # Numero di parametri passati alla funzione insufficiente. # ^^^^^^ Nessun parametro passato avrà mai un valore simile. max2 () # "Restituisce" il maggiore di due numeri. { if [ -z "$2" ] then echo $E_ERR_PARAM return fi if [ "$1" -eq "$2" ] then echo $UGUALI return else if [ "$1" -gt "$2" ] then valritorno=$1 else valritorno=$2 fi fi echo $valritorno # Visualizza (allo stdout) il valore invece di restituirlo. # Perché? } val_ritorno=$(max2 33001 33997) # ^^^^ Nome della funzione # ^^^^^ ^^^^^ Parametri passati # Si tratta, in realtà, di una forma di sostituzione di comando: #+ che tratta una funzione come se fosse un comando #+ e che assegna lo stdout della funzione alla variabile "val_ritorno". # =============================== RISULTATO ============================== if [ "$val_ritorno" -eq "$E_ERR_PARAM" ] then echo "Errore nel numero di parametri passati alla funzione di confronto!" elif [ "$val_ritorno" -eq "$UGUALI" ] then echo "I due numeri sono uguali." else echo "Il maggiore dei due numeri è $val_ritorno." fi # ======================================================================== exit 0 # Esercizi: # -------- # 1) Trovate un modo più elegante per verificare #+ il numero di parametri passati alla funzione. # 2) Semplificate la struttura if/then presente nel blocco "RISULTATO." # 3) Riscrivete lo script in modo che l'input sia dato dai parametri passati #+ da riga di comando. Ecco un altro esempio di " cattura" del "valore di ritorno" di una funzione. Per comprenderlo è necessario conoscere un po' awk. durata_mese () # Vuole come argomento il numero #+ del mese. { # Restituisce il numero dei giorni del mese. Gmese="31 28 31 30 31 30 31 31 30 31 30 31" # Dichiarata come locale? echo "$Gmese" | awk '{ print $'"${1}"' }' # Trucco. # ^^^^^^^^^ # Parametro passato alla funzione ($1 -- numero del mese) e poi a awk. # Awk lo vede come "print $1 . . . print $12" (secondo il numero del mese) # Modello per il passaggio di un parametro a uno script awk incorporato: # $'"${parametro_script}"' # È necessaria una verifica di correttezza dell'intervallo (1-12) #+ e dei giorni di febbraio per gli anni bisestili. } # ---------------------------------------------- # Esempio di utilizzo: mese=4 # aprile, (4o mese). nr_giorni=$(durata_mese $mese) echo $nr_giorni # 30 # ---------------------------------------------- Vedi anche Esempio A-7. Esercizio: Utilizzando le conoscenze fin qui acquisite, si estenda il precedente esempio dei numeri romani in modo che accetti un input arbitrario maggiore di 255.

Redirezione

Redirigere lo stdin di una funzione

Una funzione è essenzialmente un blocco di codice, il che significa che il suo stdin può essere rediretto (come in Esempio 3-1).

Esempio 23-11. Il vero nome dal nome utente

#!/bin/bash # realname.sh # Partendo dal nome dell'utente, ricava il "vero nome" da /etc/passwd. CONTOARG=1 # Si aspetta un argomento. E_ERR_ARG=65 file=/etc/passwd modello=$1 if [ $# -ne "$CONTOARG" ] then echo "Utilizzo: `basename $0` NOME-UTENTE" exit $E_ERR_ARG fi ricerca () # Esamina il file alla ricerca del modello, quindi visualizza #+ la parte rilevante della riga. { while read riga # "while" non necessariamente vuole la "[ condizione]" do echo "$riga" | grep $1 | awk -F":" '{ print $5 }' # awk deve usare #+ i ":" come delimitatore. done } <$file # Redirige nello stdin della funzione. ricerca $modello # Certo, l'intero script si sarebbe potuto ridurre a # grep MODELLO /etc/passwd | awk -F":" '{ print $5 }' # oppure # awk -F: '/MODELLO/ {print $5}' # oppure # awk -F: '($1 == "nomeutente") { print $5 }' # il vero nome dal #+ nome utente # Tuttavia, non sarebbe stato altrettanto istruttivo. exit 0

Esiste un metodo alternativo, che confonde forse meno, per redirigere lo stdin di una funzione. Questo comporta la redirezione dello stdin in un blocco di codice compreso tra parentesi graffe all'interno della funzione.

# Invece di: Funzione () { ... } < file # Provate: Funzione () { { ... } < file } # Analogamente, Funzione () # Questa funziona. { { echo $* } | tr a b } Funzione () # Questa, invece, no. { echo $* } | tr a b # In questo caso è obbligatorio il blocco di codice annidato. # Grazie, S.C.