CrtCloseHdlr(3)

CrtCloseHdlr3

Arrange for callbacks when channels are closed

Usage

#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 procedure to call as the callback. Arbitrary one-word value to pass to proc.

Overview

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.

Keywords

callback, channel closing

Releases

163 releases since Mac OS X 10.0; the text changed 3 times.

  1. 10.0–10.3.9
  2. 10.4–10.4.2
  3. 10.4.3–10.5.8
  4. 10.6–26.5

From tcl 152 in macOS 26.5. Parsed by carta from the page's man source.