memchan(n) memchan(n)
__________________________________________________________________________________________________________________________________________________
NAME
memchan - C API for creating memory channels
SYNOPSIS
package require Tcl
package require memchan
Tcl_Channel Memchan_CreateMemoryChannel (Tcl_Interp *interp, int initialSize)
Tcl_Channel Memchan_CreateFifoChannel (Tcl_Interp *interp)
void Memchan_CreateFifo2Channel (Tcl_Interp *interp, Tcl_Channel *aPtr, Tcl_Channel *bPtr)
Tcl_Channel Memchan_CreateNullChannel (Tcl_Interp *interp)
Tcl_Channel Memchan_CreateZeroChannel (Tcl_Interp *interp)
Tcl_Channel Memchan_CreateRandomChannel (Tcl_Interp *interp)
_________________________________________________________________
DESCRIPTION
The memchan package provides a C API for use by third-party extension writers. This is exposed by a Tcl stubs library table to reduce ver-
sion dependency as is available for Tcl itself.
COMMAND
Tcl_Channel Memchan_CreateMemoryChannel (Tcl_Interp *interp, int initialSize)
Tcl_Channel Memchan_CreateFifoChannel (Tcl_Interp *interp)
void Memchan_CreateFifo2Channel (Tcl_Interp *interp, Tcl_Channel *aPtr, Tcl_Channel *bPtr)
Tcl_Channel Memchan_CreateNullChannel (Tcl_Interp *interp)
Tcl_Channel Memchan_CreateZeroChannel (Tcl_Interp *interp)
Tcl_Channel Memchan_CreateRandomChannel (Tcl_Interp *interp)
Each of these functions creates an returns a channel exactly as described in the Tcl command pages for each of the memchan commands. The
Tcl commands internally call these functions to create the channels.
The memchan channel accepts an initialSize argument to permit pre-allocating space for the internal buffer. Normally this may be set to 0.
The fifo2 API function looks a little different because it must return two linked channels.
SEE ALSO
Tcl_GetChannelName
COPYRIGHT
Copyright (c) 2004 Pat Thoyts <patthoyts@users.sourceforge.net>
Memory channels 2.2 memchan(n)