Linux Manuals session 3

Tcl_CreateTrace, Tcl_CreateObjTrace, Tcl_DeleteTrace – arrange for command execution to be traced Synopsis #include <tcl.h> Tcl_Trace Tcl_CreateTrace(interp, level, proc, clientData) Tcl_Trace Tcl_CreateObjTrace(interp, level, flags, objProc, clientData, deleteProc) Tcl_DeleteTrace(interp, trace) Arguments Tcl_Interp *interp (in) Interpreter containing command to be traced or untraced. int level (in) Only commands at or below this nesting level will be traced unless…

Tcl_CreateTimerHandler, Tcl_DeleteTimerHandler – call a procedure at a given time Synopsis #include <tcl.h> Tcl_TimerToken Tcl_CreateTimerHandler(milliseconds, proc, clientData) Tcl_DeleteTimerHandler(token) Arguments int milliseconds (in) How many milliseconds to wait before invoking proc. Tcl_TimerProc *proc (in) Procedure to invoke after milliseconds have elapsed. ClientData clientData (in) Arbitrary one-word value to pass to proc. Tcl_TimerToken token (in) Token for…

Tcl_Exit, Tcl_Finalize, Tcl_CreateExitHandler, Tcl_DeleteExitHandler, Tcl_ExitThread, Tcl_FinalizeThread, Tcl_CreateThreadExitHandler, Tcl_DeleteThreadExitHandler, Tcl_SetExitProc – end the application or thread (and invoke exit handlers) Synopsis #include <tcl.h> Tcl_Exit(status) Tcl_Finalize() Tcl_CreateExitHandler(proc, clientData) Tcl_DeleteExitHandler(proc, clientData) Tcl_ExitThread(status) Tcl_FinalizeThread() Tcl_CreateThreadExitHandler(proc, clientData) Tcl_DeleteThreadExitHandler(proc, clientData) Tcl_ExitProc * Tcl_SetExitProc(proc) Arguments int status (in) Provides information about why the application or thread exited. Exact meaning may be platform-specific….

Tcl_AppendExportList, Tcl_CreateNamespace, Tcl_DeleteNamespace, Tcl_Export, Tcl_FindCommand, Tcl_FindNamespace, Tcl_ForgetImport, Tcl_GetCurrentNamespace, Tcl_GetGlobalNamespace, Tcl_GetNamespaceUnknownHandler, Tcl_Import, Tcl_SetNamespaceUnknownHandler – manipulate namespaces Synopsis #include <tcl.h> Tcl_Namespace * Tcl_CreateNamespace(interp, name, clientData, deleteProc) Tcl_DeleteNamespace(nsPtr) int Tcl_AppendExportList(interp, nsPtr, objPtr) int Tcl_Export(interp, nsPtr, pattern, resetListFirst) int Tcl_Import(interp, nsPtr, pattern, allowOverwrite) int Tcl_ForgetImport(interp, nsPtr, pattern) Tcl_Namespace * Tcl_GetCurrentNamespace(interp) Tcl_Namespace * Tcl_GetGlobalNamespace(interp) Tcl_Namespace * Tcl_FindNamespace(interp, name, contextNsPtr, flags)…

Tcl_CreateInterp, Tcl_DeleteInterp, Tcl_InterpDeleted – create and delete Tcl command interpreters Synopsis #include <tcl.h> Tcl_Interp * Tcl_CreateInterp() Tcl_DeleteInterp(interp) int Tcl_InterpDeleted(interp) Arguments Tcl_Interp *interp (in) Token for interpreter to be destroyed. Description Tcl_CreateInterp creates a new interpreter structure and returns a token for it. The token is required in calls to most other Tcl procedures, such as…

Tcl_InitHashTable, Tcl_InitCustomHashTable, Tcl_InitObjHashTable, Tcl_DeleteHashTable, Tcl_CreateHashEntry, Tcl_DeleteHashEntry, Tcl_FindHashEntry, Tcl_GetHashValue, Tcl_SetHashValue, Tcl_GetHashKey, Tcl_FirstHashEntry, Tcl_NextHashEntry, Tcl_HashStats – procedures to manage hash tables Synopsis #include <tcl.h> Tcl_InitHashTable(tablePtr, keyType) Tcl_InitCustomHashTable(tablePtr, keyType, typePtr) Tcl_InitObjHashTable(tablePtr) Tcl_DeleteHashTable(tablePtr) Tcl_HashEntry * Tcl_CreateHashEntry(tablePtr, key, newPtr) Tcl_DeleteHashEntry(entryPtr) Tcl_HashEntry * Tcl_FindHashEntry(tablePtr, key) ClientData Tcl_GetHashValue(entryPtr) Tcl_SetHashValue(entryPtr, value) char * Tcl_GetHashKey(tablePtr, entryPtr) Tcl_HashEntry * Tcl_FirstHashEntry(tablePtr, searchPtr) Tcl_HashEntry * Tcl_NextHashEntry(searchPtr) char…

Tcl_InitHashTable, Tcl_InitCustomHashTable, Tcl_InitObjHashTable, Tcl_DeleteHashTable, Tcl_CreateHashEntry, Tcl_DeleteHashEntry, Tcl_FindHashEntry, Tcl_GetHashValue, Tcl_SetHashValue, Tcl_GetHashKey, Tcl_FirstHashEntry, Tcl_NextHashEntry, Tcl_HashStats – procedures to manage hash tables Synopsis #include <tcl.h> Tcl_InitHashTable(tablePtr, keyType) Tcl_InitCustomHashTable(tablePtr, keyType, typePtr) Tcl_InitObjHashTable(tablePtr) Tcl_DeleteHashTable(tablePtr) Tcl_HashEntry * Tcl_CreateHashEntry(tablePtr, key, newPtr) Tcl_DeleteHashEntry(entryPtr) Tcl_HashEntry * Tcl_FindHashEntry(tablePtr, key) ClientData Tcl_GetHashValue(entryPtr) Tcl_SetHashValue(entryPtr, value) char * Tcl_GetHashKey(tablePtr, entryPtr) Tcl_HashEntry * Tcl_FirstHashEntry(tablePtr, searchPtr) Tcl_HashEntry * Tcl_NextHashEntry(searchPtr) char…

Tcl_CreateFileHandler, Tcl_DeleteFileHandler – associate procedure callbacks with files or devices (Unix only) Synopsis #include <tcl.h> Tcl_CreateFileHandler(fd, mask, proc, clientData) Tcl_DeleteFileHandler(fd) Arguments int fd (in) Unix file descriptor for an open file or device. int mask (in) Conditions under which proc should be called: OR-ed combination of TCL_READABLE, TCL_WRITABLE, and TCL_EXCEPTION. May be set to 0…

Tcl_Exit, Tcl_Finalize, Tcl_CreateExitHandler, Tcl_DeleteExitHandler, Tcl_ExitThread, Tcl_FinalizeThread, Tcl_CreateThreadExitHandler, Tcl_DeleteThreadExitHandler, Tcl_SetExitProc – end the application or thread (and invoke exit handlers) Synopsis #include <tcl.h> Tcl_Exit(status) Tcl_Finalize() Tcl_CreateExitHandler(proc, clientData) Tcl_DeleteExitHandler(proc, clientData) Tcl_ExitThread(status) Tcl_FinalizeThread() Tcl_CreateThreadExitHandler(proc, clientData) Tcl_DeleteThreadExitHandler(proc, clientData) Tcl_ExitProc * Tcl_SetExitProc(proc) Arguments int status (in) Provides information about why the application or thread exited. Exact meaning may be platform-specific….

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_CreateObjCommand, Tcl_DeleteCommand, Tcl_DeleteCommandFromToken, Tcl_GetCommandInfo, Tcl_GetCommandInfoFromToken, Tcl_SetCommandInfo, Tcl_SetCommandInfoFromToken, Tcl_GetCommandName, Tcl_GetCommandFullName, Tcl_GetCommandFromObj – implement new commands in C Synopsis #include <tcl.h> Tcl_Command Tcl_CreateObjCommand(interp, cmdName, proc, clientData, deleteProc) int Tcl_DeleteCommand(interp, cmdName) int Tcl_DeleteCommandFromToken(interp, token) int Tcl_GetCommandInfo(interp, cmdName, infoPtr) int Tcl_SetCommandInfo(interp, cmdName, infoPtr) int Tcl_GetCommandInfoFromToken(token, infoPtr) int Tcl_SetCommandInfoFromToken(token, infoPtr) const char * Tcl_GetCommandName(interp, token) void Tcl_GetCommandFullName(interp, token, objPtr) Tcl_Command…

Tcl_CreateObjCommand, Tcl_DeleteCommand, Tcl_DeleteCommandFromToken, Tcl_GetCommandInfo, Tcl_GetCommandInfoFromToken, Tcl_SetCommandInfo, Tcl_SetCommandInfoFromToken, Tcl_GetCommandName, Tcl_GetCommandFullName, Tcl_GetCommandFromObj – implement new commands in C Synopsis #include <tcl.h> Tcl_Command Tcl_CreateObjCommand(interp, cmdName, proc, clientData, deleteProc) int Tcl_DeleteCommand(interp, cmdName) int Tcl_DeleteCommandFromToken(interp, token) int Tcl_GetCommandInfo(interp, cmdName, infoPtr) int Tcl_SetCommandInfo(interp, cmdName, infoPtr) int Tcl_GetCommandInfoFromToken(token, infoPtr) int Tcl_SetCommandInfoFromToken(token, infoPtr) const char * Tcl_GetCommandName(interp, token) void Tcl_GetCommandFullName(interp, token, objPtr) Tcl_Command…

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 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…

Tcl_CreateChannelHandler, Tcl_DeleteChannelHandler – call a procedure when a channel becomes readable or writable Synopsis #include <tcl.h> void Tcl_CreateChannelHandler(channel, mask, proc, clientData) void Tcl_DeleteChannelHandler(channel, proc, clientData) Arguments Tcl_Channel channel (in) Tcl channel such as returned by Tcl_CreateChannel. int mask (in) Conditions under which proc should be called: OR-ed combination of TCL_READABLE, TCL_WRITABLE and TCL_EXCEPTION. Specify a…

Tcl_GetAssocData, Tcl_SetAssocData, Tcl_DeleteAssocData – manage associations of string keys and user specified data with Tcl interpreters Synopsis #include <tcl.h> ClientData Tcl_GetAssocData(interp, key, delProcPtr) Tcl_SetAssocData(interp, key, delProc, clientData) Tcl_DeleteAssocData(interp, key) Arguments Tcl_Interp *interp (in) Interpreter in which to execute the specified command. const char *key (in) Key for association with which to store data or from…

Tcl_NewObj, Tcl_DuplicateObj, Tcl_IncrRefCount, Tcl_DecrRefCount, Tcl_IsShared, Tcl_InvalidateStringRep – manipulate Tcl objects Synopsis #include <tcl.h> Tcl_Obj * Tcl_NewObj() Tcl_Obj * Tcl_DuplicateObj(objPtr) Tcl_IncrRefCount(objPtr) Tcl_DecrRefCount(objPtr) int Tcl_IsShared(objPtr) Tcl_InvalidateStringRep(objPtr) Arguments Tcl_Obj *objPtr (in) Points to an object; must have been the result of a previous call to Tcl_NewObj. Introduction This man page presents an overview of Tcl objects and how…

Tcl_DStringInit, Tcl_DStringAppend, Tcl_DStringAppendElement, Tcl_DStringStartSublist, Tcl_DStringEndSublist, Tcl_DStringLength, Tcl_DStringValue, Tcl_DStringSetLength, Tcl_DStringTrunc, Tcl_DStringFree, Tcl_DStringResult, Tcl_DStringGetResult – manipulate dynamic strings Synopsis #include <tcl.h> Tcl_DStringInit(dsPtr) char * Tcl_DStringAppend(dsPtr, bytes, length) char * Tcl_DStringAppendElement(dsPtr, element) Tcl_DStringStartSublist(dsPtr) Tcl_DStringEndSublist(dsPtr) int Tcl_DStringLength(dsPtr) char * Tcl_DStringValue(dsPtr) Tcl_DStringSetLength(dsPtr, newLength) Tcl_DStringTrunc(dsPtr, newLength) Tcl_DStringFree(dsPtr) Tcl_DStringResult(interp, dsPtr) Tcl_DStringGetResult(interp, dsPtr) Arguments Tcl_DString *dsPtr (in/out) Pointer to structure that is used…

Tcl_DStringInit, Tcl_DStringAppend, Tcl_DStringAppendElement, Tcl_DStringStartSublist, Tcl_DStringEndSublist, Tcl_DStringLength, Tcl_DStringValue, Tcl_DStringSetLength, Tcl_DStringTrunc, Tcl_DStringFree, Tcl_DStringResult, Tcl_DStringGetResult – manipulate dynamic strings Synopsis #include <tcl.h> Tcl_DStringInit(dsPtr) char * Tcl_DStringAppend(dsPtr, bytes, length) char * Tcl_DStringAppendElement(dsPtr, element) Tcl_DStringStartSublist(dsPtr) Tcl_DStringEndSublist(dsPtr) int Tcl_DStringLength(dsPtr) char * Tcl_DStringValue(dsPtr) Tcl_DStringSetLength(dsPtr, newLength) Tcl_DStringTrunc(dsPtr, newLength) Tcl_DStringFree(dsPtr) Tcl_DStringResult(interp, dsPtr) Tcl_DStringGetResult(interp, dsPtr) Arguments Tcl_DString *dsPtr (in/out) Pointer to structure that is used…

Tcl_DStringInit, Tcl_DStringAppend, Tcl_DStringAppendElement, Tcl_DStringStartSublist, Tcl_DStringEndSublist, Tcl_DStringLength, Tcl_DStringValue, Tcl_DStringSetLength, Tcl_DStringTrunc, Tcl_DStringFree, Tcl_DStringResult, Tcl_DStringGetResult – manipulate dynamic strings Synopsis #include <tcl.h> Tcl_DStringInit(dsPtr) char * Tcl_DStringAppend(dsPtr, bytes, length) char * Tcl_DStringAppendElement(dsPtr, element) Tcl_DStringStartSublist(dsPtr) Tcl_DStringEndSublist(dsPtr) int Tcl_DStringLength(dsPtr) char * Tcl_DStringValue(dsPtr) Tcl_DStringSetLength(dsPtr, newLength) Tcl_DStringTrunc(dsPtr, newLength) Tcl_DStringFree(dsPtr) Tcl_DStringResult(interp, dsPtr) Tcl_DStringGetResult(interp, dsPtr) Arguments Tcl_DString *dsPtr (in/out) Pointer to structure that is used…