Tcl_CreateCloseHandler(), Tcl_DeleteCloseHandler()

arrange for callbacks when channels are closed 

Tcl Library Procedures


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 create or delete a close callback.

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_DeleteCloseHandler() does nothing if its proc and clientData arguments do not match the proc and clientData for a close handler for channel.


PORTABILITY

Windows 8.1. Windows Server 2012 R2. Windows 10. Windows Server 2016. Windows Server 2019. Windows 11. Windows Server 2022.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Commands:
close

Functions:
Tcl_Close(), Tcl_UnregisterChannel()


PTC MKS Toolkit 10.4 Documentation Build 39.