tcl.lang
Interface VarTrace

public interface VarTrace

This interface is used to make variable traces. To make a variable trace, write a class that implements the VarTrace and call Interp.traceVar with an instance of that class.

Method Summary

void	traceProc(Interp interp, String part1, String part2, int flags) This function gets called when a variable is accessed.

Method Detail

traceProc

void traceProc(Interp interp,
               String part1,
               String part2,
               int flags)
               throws TclException

This function gets called when a variable is accessed. Results: None. Side effects: The traceProc can cause arbitrary side effects. If a TclException is thrown, error message is stored in the result of the interpreter.

Parameters:

interp - current interpreter

part1 - first part of variable name

part2 - array index, or if null, part1 is a scalar or whole array

flags - TCL.TRACE_READS, TCL.TRACE_WRITES or TCL.TRACE_UNSETS (exactly one of these bits will be set.)

Throws:

TclException