Manual Pages for UNIX Operating System command usage for man Tcl_CallWhenDeleted

Tcl Library Procedures                  Tcl_CallWhenDeleted(3TCL)



_________________________________________________________________

NAME
     Tcl_CallWhenDeleted, Tcl_DontCallWhenDeleted -  Arrange  for
     callback when interpreter is deleted

SYNOPSIS
     #include 

     Tcl_CallWhenDeleted(interp, proc, clientData)

     Tcl_DontCallWhenDeleted(interp, proc, clientData)

ARGUMENTS
     Tcl_Interp             *interp      (in)      Interpreter
                                                   with  which to
                                                   associated
                                                   callback.

     Tcl_InterpDeleteProc   *proc        (in)      Procedure   to
                                                   call      when
                                                   interp      is
                                                   deleted.

     ClientData             clientData   (in)      Arbitrary
                                                   one-word value
                                                   to   pass   to
                                                   proc.
_________________________________________________________________


DESCRIPTION
     Tcl_CallWhenDeleted  arranges  for  proc  to  be  called  by
     Tcl_DeleteInterp  if/when  interp  is deleted at some future
     time.  Proc will be invoked just before the  interpreter  is
     deleted, but the interpreter will still be valid at the time
     of the call.  Proc should have  arguments  and  result  that
     match the type Tcl_InterpDeleteProc:
          typedef void Tcl_InterpDeleteProc(
            ClientData clientData,
            Tcl_Interp *interp);
     The clientData and  interp  parameters  are  copies  of  the
     clientData     and     interp     arguments     given     to
     Tcl_CallWhenDeleted.  Typically,  clientData  points  to  an
     application-specific  data  structure that proc uses to per-
     form cleanup when an interpreter is about to go away.   Proc
     does not return a value.

     Tcl_DontCallWhenDeleted   cancels   a   previous   call   to
     Tcl_CallWhenDeleted  with  the  same arguments, so that proc
     won't be called after all when interp is deleted.  If  there
     is  no  deletion  callback  that  matches  interp, proc, and



Tcl                     Last change: 7.0                        1






Tcl Library Procedures                  Tcl_CallWhenDeleted(3TCL)



     clientData then the call to Tcl_DontCallWhenDeleted  has  no
     effect.


KEYWORDS
     callback, delete, interpreter

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tcl is available on http://opensolaris.org.


































Tcl                     Last change: 7.0                        2