Tcl_CreateCloseHandler(3TCL)Tcl Library ProceduresTcl_CreateCloseHandler(3TCL)______________________________________________________________________________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
Tcl_Channel channel (in) The channel for which to cre‐
ate or delete a close call‐
back.
Tcl_CloseProc *proc (in) The procedure to call as the
callback.
ClientData clientData (in) 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 ALSOclose(1T), Tcl_Close(3TCL), Tcl_UnregisterChannel(3TCL)KEYWORDS
callback, channel closing
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Availability │ runtime/tcl-8 │
├────────────────────┼─────────────────┤
│Interface Stability │ Uncommitted │
└────────────────────┴─────────────────┘
NOTES
Source for Tcl is available on http://opensolaris.org.
Tcl 7.5 Tcl_CreateCloseHandler(3TCL)