Premessa
Quando durante l’esecuzione di un comando avviene un errore, l’Interprete Tcl valorizza le variabili globali errorInfo ed errorCode e viene quindi generata una condizione di errore che si propaga lungo la pila delle eventuali procedure coinvolte.
Promemoria: in Tcl il termine procedura è sinonimo di comando.
# esempio
puts "test #1"
putss "test #2"
---
test #1
invalid command name "putss"
while executing
"putss "test #2""
(file "016_errors_2.tcl" line 2)
Propagazione di un errore
Supponiamo di aver mandato in esecuzione il comando o la procedura denominata proc1 che a sua volta invoca la procedura proc2 e questa la proc3.
Se all’interno della procedura proc3 avviene un errore, questo risale lungo la catena delle chiamate (call stack) sino ad arrivare alla prima procedura chiamante: la proc1. Ciascuna procedura aggiungerà delle informazioni circa l’errore accaduto fornendo in questo modo un report molto utile per il programmatore o per l’utente.
Il fatto che la procedura proc3 abbia generato un errore fa sì che, sia essa, che tutte le altre procedure coinvolte nella catena delle chiamate, non eseguano le successive istruzioni.
# esempio
proc proc1 {} {
puts "I am proc1"
proc2
}
proc proc2 {} {
puts "I am proc2"
command_unknown
proc3
}
proc proc3 {} {
puts "I am proc3"
}
# Run the top-level proc
proc1
---
I am proc1
I am proc2
invalid command name "command_unknown"
while executing
"command_unknown"
(procedure "proc2" line 3)
invoked from within
"proc2"
(procedure "proc1" line 3)
invoked from within
"proc1"
(file "015_errors.tcl" line 16)
Come gestire l’eventualità di un errore
Comando return
Nell’articolo Come creare un nuovo comando abbiamo parlato del comando return che permette ad una procedura di restituire un determinato valore.
Possiamo utilizzare questo stesso comando per gestire anche l’eventualità di un errore.
# sintassi
return ?-code code? ?-errorinfo info? ?-errorcode errorcode? ?value?
L’argomento facoltativo ?code? può assumere uno dei seguenti valori:
ok– restituisce lo stato normaleerror– restituisce lo stato di errore e quindi le informazioni relative all’errore (infoederrorcode)return– restituisce?value?se valorizzatobreak– restituisce lo stato break (come avviene per il comandobreak)continue– restituisce lo stato continue (come avviene per il comandocontinue)
La stringa facoltativa ?value? rappresenta l’informazione restituita dal comando return se non avvengono errori.
Comando catch
Per evitare che il nostro programma si interrompa a causa di un errore, possiamo utilizzare il comando catch.
# sintassi
catch script ?varName?
Se il codice riportato nella parte che abbiamo indicato con il termine script genera un errore, allora il comando catch restituisce il valore 1, altrimenti restituisce 0.
Se specifichiamo ?varName? e script non genera errori, allora il valore restituito da script viene associato a varName, altrimenti varName viene valorizzata con l’errore.
catch {expr {4 + 3}} errorVar1
puts "errorVar1 = $errorVar1"
catch {exprr {4 + 3}} errorVar2
puts "\nerrorVar2 = $errorVar2"
puts "\n[catch {exprr {4 + 3}}]"
---
errorVar1 = 7
errorVar2 = invalid command name "exprr"
1
In questo modo possiamo scrivere del codice alternativo che magari informi l’utente di ciò che è accaduto senza interrompere l’intero programma.
Comando error
# sintassi
error message ?info? ?code?
Con questo comando generiamo intenzionalmente una condizione di errore che interrompe la prosecuzione delle istruzioni successive e forza l’Interprete Tcl a risalire lungo la catena delle chiamate. Se valorizziamo gli argomenti ?info? e ?code?, vengono inizializzate rispettivamente le variabili errorInfo ed errorCode che vengono riportate nel report finale.
Nel prossimo articolo vedremo come tracciare lo stato di una variabile.