Mastodon
Seleziona una pagina

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:

  • write
  • read
  • unset
  • array

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 upvar può 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.