manpagez: man pages & more
man CrtCloseHdlr(3)
Home | html | info | man
Tcl_CreateCloseHandler(3)   Tcl Library Procedures   Tcl_CreateCloseHandler(3)




NAME

       Tcl_CreateCloseHandler,  Tcl_DeleteCloseHandler - arrange for callbacks
       when channels are closed


SYNOPSIS

       #include <tcl.h>

       void
       Tcl_CreateCloseHandler(channel, proc, clientData)

       void
       Tcl_DeleteCloseHandler(channel, proc, clientData)



ARGUMENTS

       The channel for which to create or delete a close callback.  The proce-
       dure  to  call  as  the  callback.  Arbitrary one-word value to pass to
       proc.



DESCRIPTION

       Tcl_CreateCloseHandler arranges for proc to be called when  channel  is
       closed  with Tcl_Close or Tcl_UnregisterChannel, or using the Tcl close
       command.  Proc should match the following prototype:

       typedef void Tcl_CloseProc(
               ClientData clientData);

       The clientData is the same  as  the  value  provided  in  the  call  to
       Tcl_CreateCloseHandler.

       Tcl_DeleteCloseHandler  removes a close callback for channel.  The proc
       and clientData identify which close  callback  to  remove;  Tcl_Delete-
       CloseHandler  does  nothing if its proc and clientData arguments do not
       match the proc and clientData for a  close handler for channel.



SEE ALSO

       close(n), Tcl_Close(3), Tcl_UnregisterChannel(3)



KEYWORDS

       callback, channel closing



Tcl                                   7.5            Tcl_CreateCloseHandler(3)

CrtCloseHdlr 8.5.4 - Generated Sun Aug 17 20:43:35 CDT 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.