Content-type: text/html Man page of Tracing TCL Variables

Tracing TCL Variables

Section: NSCL Data Analysis Packages (3)
Updated: 0.1
Index Return to Main Contents

NAME

CVariableTraceCallback - Abstract base class for Tcl/Tk variable traces

SYNOPSIS


#include <VariableTraceCallback.h>


class CVariableTraceCallback 
{
 public:
  virtual char* operator()(CTCLInterpreter* pInterp,
                           char* pVariable, 
                           char* pElement,
                           int   flags) = 0;
};

DESCRIPTION

CVariableTraceCallback is an abstract base class that defines an interface that must be implemented by callback objects registered on CTCLTracedVariable objects.

PUBLIC INTERFACE

virtual char* operator()(CTCLInterpreter* pInterp, char* pVariable,char* pElement, int flags) = 0;: This function must be overridden and implemented by the programmer creating trace callbacks. pInterp is a pointer to the encapsulated Tcl interpreter. pVariable is a pointer to a null terminated string that is the name of the variable on which the trace fired. If the trace fired on an element of an array, pElement is a pointer to the name of the element. If the trace fired on a scaler, pElement is a null pointer. flags indicates why the trace fires. It will be one of the flags TCL_TRACE_READS, TCL_TRACE_WRITES, TCL_TRACE_UNSETS or.
TCL_TRACE_DESTROYED will be set if the trace is getting removed, an finally, TCL_INTERP_DESTROYED is set if the interpreter is getting destroyed.

EXAMPLES

This document was created by man2html, using the manual pages.
Time: 14:18:39 GMT, February 25, 2005