Quando si fa il debugging del codice, alle volte è utile ispezionare lo stato di una variabile.
Il comando che Tcl mette a disposizione è trace.
Di seguito vedremo le tre più comuni operazioni che possiamo gestire con questo comando.
Aggiungere un tracciamento
# sintassi
trace add variable name opt commandPrefix
Con questa istruzione si chiede all’Interprete Tcl di tracciare la variabile name e di eseguire il comando commandPrefix quando questa variabile è interessata dall’operazione specificata nell’argomento opt.
L’argomento name è quindi il nome della variabile su cui attivare il tracciamento.
L’argomento opt ci permette di impostare una delle seguenti operazioni da tracciare:
writereadunsetarray
Infine l’argomento commandPrefix è il comando da eseguire, come già detto, quando la variabile name è interessata dall’operazione opt.
Quando viene intercettata l’operazione tracciata, al commandPrefix vengono automaticamente aggiunti tre argomenti:
commandPrefix varname element opt
- varname è il nome per la variabile a cui si è acceduto (tramite il comando
upvarpuò essere anche differente rispetto a quello indicato nel tracciamento). - element indica quale indice di un eventuale array è stato interessato dall’operazione tracciata.
- opt indica l’operazione tracciata.
Esempio di utilizzo
Nell’esempio seguente sfrutteremo il tracciamento su una variabile per fare in modo che il suo valore non venga modificato.
# esempio
proc vartrace {oldval varname element opt} {
upvar $varname localvar
set localvar $oldval
}
set tracedvar 1
trace add variable tracedvar write [list vartrace $tracedvar]
set tracedvar 2; qui avviene il tentativo di scrittura che attiva il comando commandPrefix
puts "tracedvar is $tracedvar"
---
tracedvar is 1
Quando il tracciamento viene chiamato, la procedura vartrace ripristina il valore della variabile al suo valore originale.
Ottenere informazioni
# sintassi
trace info variable name
Questo comando restituisce una lista contenente un elemento per ogni tracciamento impostato sulla variabile name. Ogni elemento della lista è a sua volta una lista contenente due elementi (opt e commandPrefix) associati al tracciamento. Se la variabile name non esiste o non ha su di essa dei tracciamenti attivi, allora il comando restituirà una stringa vuota.
Rimuovere un tracciamento
# sintassi
trace remove variable name opt commandPrefix
Se esiste un tracciamento attivo sulla variabile name per l’operazione opt associato al comando commandPrefix, allora il tracciamento verrà rimosso e il comando commandPrefix non potrà più essere invocato. Questa istruzione restituisce una stringa vuota.
Nel prossimo articolo vedremo come misurare il tempo di esecuzione di uno script.