NAME

       Tcl_CallWhenDeleted, Tcl_DontCallWhenDeleted - Arrange for
       callback when interpreter is deleted

SYNOPSIS

       #include <tcl.h>

       Tcl_CallWhenDeleted(interp, proc, clientData)

       Tcl_DontCallWhenDeleted(interp, proc, clientData)

ARGUMENTS

       Tcl_Interp             *interp      (in)      Interpreter
                                                     with   which
                                                     to   associ-
                                                     ated   call-
                                                     back.

       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
       has no effect.

KEYWORDS

       callback, delete, interpreter