Linux Manuals session 3

Tcl_CommandTraceInfo, Tcl_TraceCommand, Tcl_UntraceCommand – monitor renames and deletes of a command Synopsis #include <tcl.h> ClientData Tcl_CommandTraceInfo(interp, cmdName, flags, proc, prevClientData) int Tcl_TraceCommand(interp, cmdName, flags, proc, clientData) void Tcl_UntraceCommand(interp, cmdName, flags, proc, clientData) Arguments Tcl_Interp *interp (in) Interpreter containing the command. const char *cmdName (in) Name of command. int flags (in) OR’ed collection of the values…

Tcl_CreateEventSource, Tcl_DeleteEventSource, Tcl_SetMaxBlockTime, Tcl_QueueEvent, Tcl_ThreadQueueEvent, Tcl_ThreadAlert, Tcl_GetCurrentThread, Tcl_DeleteEvents, Tcl_InitNotifier, Tcl_FinalizeNotifier, Tcl_WaitForEvent, Tcl_AlertNotifier, Tcl_SetTimer, Tcl_ServiceAll, Tcl_ServiceEvent, Tcl_GetServiceMode, Tcl_SetServiceMode – the event queue and notifier interfaces Synopsis #include <tcl.h> void Tcl_CreateEventSource(setupProc, checkProc, clientData) void Tcl_DeleteEventSource(setupProc, checkProc, clientData) void Tcl_SetMaxBlockTime(timePtr) void Tcl_QueueEvent(evPtr, position) void Tcl_ThreadQueueEvent(threadId, evPtr, position) void Tcl_ThreadAlert(threadId) Tcl_ThreadId Tcl_GetCurrentThread() void Tcl_DeleteEvents(deleteProc, clientData) ClientData Tcl_InitNotifier() void Tcl_FinalizeNotifier(clientData)…

Tcl_CreateEventSource, Tcl_DeleteEventSource, Tcl_SetMaxBlockTime, Tcl_QueueEvent, Tcl_ThreadQueueEvent, Tcl_ThreadAlert, Tcl_GetCurrentThread, Tcl_DeleteEvents, Tcl_InitNotifier, Tcl_FinalizeNotifier, Tcl_WaitForEvent, Tcl_AlertNotifier, Tcl_SetTimer, Tcl_ServiceAll, Tcl_ServiceEvent, Tcl_GetServiceMode, Tcl_SetServiceMode – the event queue and notifier interfaces Synopsis #include <tcl.h> void Tcl_CreateEventSource(setupProc, checkProc, clientData) void Tcl_DeleteEventSource(setupProc, checkProc, clientData) void Tcl_SetMaxBlockTime(timePtr) void Tcl_QueueEvent(evPtr, position) void Tcl_ThreadQueueEvent(threadId, evPtr, position) void Tcl_ThreadAlert(threadId) Tcl_ThreadId Tcl_GetCurrentThread() void Tcl_DeleteEvents(deleteProc, clientData) ClientData Tcl_InitNotifier() void Tcl_FinalizeNotifier(clientData)…

Tcl_OpenFileChannel, Tcl_OpenCommandChannel, Tcl_MakeFileChannel, Tcl_GetChannel, Tcl_GetChannelNames, Tcl_GetChannelNamesEx, Tcl_RegisterChannel, Tcl_UnregisterChannel, Tcl_DetachChannel, Tcl_IsStandardChannel, Tcl_Close, Tcl_ReadChars, Tcl_Read, Tcl_GetsObj, Tcl_Gets, Tcl_WriteObj, Tcl_WriteChars, Tcl_Write, Tcl_Flush, Tcl_Seek, Tcl_Tell, Tcl_TruncateChannel, Tcl_GetChannelOption, Tcl_SetChannelOption, Tcl_Eof, Tcl_InputBlocked, Tcl_InputBuffered, Tcl_OutputBuffered, Tcl_Ungets, Tcl_ReadRaw, Tcl_WriteRaw – buffered I/O facilities using channels Synopsis #include <tcl.h> Tcl_Channel Tcl_OpenFileChannel(interp, fileName, mode, permissions) Tcl_Channel Tcl_OpenCommandChannel(interp, argc, argv, flags) Tcl_Channel Tcl_MakeFileChannel(handle, readOrWrite) Tcl_Channel Tcl_GetChannel(interp,…

Tcl_NewIntObj, Tcl_NewLongObj, Tcl_NewWideIntObj, Tcl_SetIntObj, Tcl_SetLongObj, Tcl_SetWideIntObj, Tcl_GetIntFromObj, Tcl_GetLongFromObj, Tcl_GetWideIntFromObj, Tcl_NewBignumObj, Tcl_SetBignumObj, Tcl_GetBignumFromObj, Tcl_TakeBignumFromObj – manipulate Tcl objects as integer values Synopsis #include <tcl.h> Tcl_Obj * Tcl_NewIntObj(intValue) Tcl_Obj * Tcl_NewLongObj(longValue) Tcl_Obj * Tcl_NewWideIntObj(wideValue) Tcl_SetIntObj(objPtr, intValue) Tcl_SetLongObj(objPtr, longValue) Tcl_SetWideIntObj(objPtr, wideValue) int Tcl_GetIntFromObj(interp, objPtr, intPtr) int Tcl_GetLongFromObj(interp, objPtr, longPtr) int Tcl_GetWideIntFromObj(interp, objPtr, widePtr) #include <tclTomMath.h> Tcl_Obj * Tcl_NewBignumObj(bigValue)…

Tcl_SubstObj – perform substitutions on Tcl objects Synopsis #include <tcl.h> Tcl_Obj * Tcl_SubstObj(interp, objPtr, flags) Arguments Tcl_Interp *interp (in) Interpreter in which to execute Tcl scripts and lookup variables. If an error occurs, the interpreter’s result is modified to hold an error message. Tcl_Obj *objPtr (in) A Tcl object containing the string to perform substitutions…

Tcl_StringMatch, Tcl_StringCaseMatch – test whether a string matches a pattern Synopsis #include <tcl.h> int Tcl_StringMatch(str, pattern) int Tcl_StringCaseMatch(str, pattern, flags) Arguments const char *str (in) String to test. const char *pattern (in) Pattern to match against string. May contain special characters from the set *?\[]. int flags (in) OR-ed combination of match flags, currently only…

Tcl_StringMatch, Tcl_StringCaseMatch – test whether a string matches a pattern Synopsis #include <tcl.h> int Tcl_StringMatch(str, pattern) int Tcl_StringCaseMatch(str, pattern, flags) Arguments const char *str (in) String to test. const char *pattern (in) Pattern to match against string. May contain special characters from the set *?\[]. int flags (in) OR-ed combination of match flags, currently only…

Tcl_StaticPackage – make a statically linked package available via the ‘load’ command Synopsis #include <tcl.h> Tcl_StaticPackage(interp, pkgName, initProc, safeInitProc) Arguments Tcl_Interp *interp (in) If not NULL, points to an interpreter into which the package has already been loaded (i.e., the caller has already invoked the appropriate initialization procedure). NULL means the package has not yet…

Tcl_Access, Tcl_Stat – check file permissions and other attributes Synopsis #include <tcl.h> int Tcl_Access(path, mode) int Tcl_Stat(path, statPtr) Arguments char *path (in) Native name of the file to check the attributes of. int mode (in) Mask consisting of one or more of R_OK, W_OK, X_OK and F_OK. R_OK, W_OK and X_OK request checking whether the…

Tcl_StandardChannels – How the Tcl library deals with the standard channels Description This page explains the initialization and use of standard channels in the Tcl library. The term standard channels comes out of the Unix world and refers to the three channels automatically opened by the OS for each new application. They are stdin, stdout…

Tcl_StackChannel, Tcl_UnstackChannel, Tcl_GetStackedChannel, Tcl_GetTopChannel – manipulate stacked I/O channels Synopsis #include <tcl.h> Tcl_Channel Tcl_StackChannel(interp, typePtr, clientData, mask, channel) int Tcl_UnstackChannel(interp, channel) Tcl_Channel Tcl_GetStackedChannel(channel) Tcl_Channel Tcl_GetTopChannel(channel) Arguments Tcl_Interp *interp (in) Interpreter for error reporting. Tcl_ChannelType *typePtr (in) The new channel I/O procedures to use for channel. ClientData clientData (in) Arbitrary one-word value to pass to channel…

Tcl_SplitPath, Tcl_JoinPath, Tcl_GetPathType – manipulate platform-dependent file paths Synopsis #include <tcl.h> Tcl_SplitPath(path, argcPtr, argvPtr) char * Tcl_JoinPath(argc, argv, resultPtr) Tcl_PathType Tcl_GetPathType(path) Arguments const char *path (in) File path in a form appropriate for the current platform (see the filename manual entry for acceptable forms for path names). int *argcPtr (out) Filled in with number of…

Tcl_SplitList, Tcl_Merge, Tcl_ScanElement, Tcl_ConvertElement, Tcl_ScanCountedElement, Tcl_ConvertCountedElement – manipulate Tcl lists Synopsis #include <tcl.h> int Tcl_SplitList(interp, list, argcPtr, argvPtr) char * Tcl_Merge(argc, argv) int Tcl_ScanElement(src, flagsPtr) int Tcl_ScanCountedElement(src, length, flagsPtr) int Tcl_ConvertElement(src, dst, flags) int Tcl_ConvertCountedElement(src, length, dst, flags) Arguments Tcl_Interp *interp (out) Interpreter to use for error reporting. If NULL, then no error message is…

Tcl_CreateChannel, Tcl_GetChannelInstanceData, Tcl_GetChannelType, Tcl_GetChannelName, Tcl_GetChannelHandle, Tcl_GetChannelMode, Tcl_GetChannelBufferSize, Tcl_SetChannelBufferSize, Tcl_NotifyChannel, Tcl_BadChannelOption, Tcl_ChannelName, Tcl_ChannelVersion, Tcl_ChannelBlockModeProc, Tcl_ChannelCloseProc, Tcl_ChannelClose2Proc, Tcl_ChannelInputProc, Tcl_ChannelOutputProc, Tcl_ChannelSeekProc, Tcl_ChannelWideSeekProc, Tcl_ChannelTruncateProc, Tcl_ChannelSetOptionProc, Tcl_ChannelGetOptionProc, Tcl_ChannelWatchProc, Tcl_ChannelGetHandleProc, Tcl_ChannelFlushProc, Tcl_ChannelHandlerProc, Tcl_ChannelThreadActionProc, Tcl_IsChannelShared, Tcl_IsChannelRegistered, Tcl_CutChannel, Tcl_SpliceChannel, Tcl_IsChannelExisting, Tcl_ClearChannelHandlers, Tcl_GetChannelThread, Tcl_ChannelBuffered – procedures for creating and manipulating channels Synopsis #include <tcl.h> Tcl_Channel Tcl_CreateChannel(typePtr, channelName, instanceData, mask) ClientData Tcl_GetChannelInstanceData(channel) Tcl_ChannelType * Tcl_GetChannelType(channel)…

Tcl_SourceRCFile – source the Tcl rc file Synopsis #include <tcl.h> void Tcl_SourceRCFile(interp) Arguments Tcl_Interp *interp (in) Tcl interpreter to source rc file into. Description Tcl_SourceRCFile is used to source the Tcl rc file at startup. It is typically invoked by Tcl_Main or Tk_Main. The name of the file sourced is obtained from the global variable…

Tcl_Sleep – delay execution for a given number of milliseconds Synopsis #include <tcl.h> Tcl_Sleep(ms) Arguments int ms (in) Number of milliseconds to sleep. Description This procedure delays the calling process by the number of milliseconds given by the ms parameter and returns after that time has elapsed. It is typically used for things like flashing…

Tcl_SignalId, Tcl_SignalMsg – Convert signal codes Synopsis #include <tcl.h> const char * Tcl_SignalId(sig) const char * Tcl_SignalMsg(sig) Arguments int sig (in) A POSIX signal number such as SIGPIPE. Description Tcl_SignalId and Tcl_SignalMsg return a string representation of the provided signal number (sig). Tcl_SignalId returns a machine-readable textual identifier such as “SIGPIPE”. Tcl_SignalMsg returns a human-readable…

Tcl_SignalId, Tcl_SignalMsg – Convert signal codes Synopsis #include <tcl.h> const char * Tcl_SignalId(sig) const char * Tcl_SignalMsg(sig) Arguments int sig (in) A POSIX signal number such as SIGPIPE. Description Tcl_SignalId and Tcl_SignalMsg return a string representation of the provided signal number (sig). Tcl_SignalId returns a machine-readable textual identifier such as “SIGPIPE”. Tcl_SignalMsg returns a human-readable…

Tcl_NewIntObj, Tcl_NewLongObj, Tcl_NewWideIntObj, Tcl_SetIntObj, Tcl_SetLongObj, Tcl_SetWideIntObj, Tcl_GetIntFromObj, Tcl_GetLongFromObj, Tcl_GetWideIntFromObj, Tcl_NewBignumObj, Tcl_SetBignumObj, Tcl_GetBignumFromObj, Tcl_TakeBignumFromObj – manipulate Tcl objects as integer values Synopsis #include <tcl.h> Tcl_Obj * Tcl_NewIntObj(intValue) Tcl_Obj * Tcl_NewLongObj(longValue) Tcl_Obj * Tcl_NewWideIntObj(wideValue) Tcl_SetIntObj(objPtr, intValue) Tcl_SetLongObj(objPtr, longValue) Tcl_SetWideIntObj(objPtr, wideValue) int Tcl_GetIntFromObj(interp, objPtr, intPtr) int Tcl_GetLongFromObj(interp, objPtr, longPtr) int Tcl_GetWideIntFromObj(interp, objPtr, widePtr) #include <tclTomMath.h> Tcl_Obj * Tcl_NewBignumObj(bigValue)…