Linux Manuals session 3

Tcl_CallWhenDeleted, Tcl_DontCallWhenDeleted – Arrange for callback when interpreter is deleted Synopsis#include <tcl.h> Tcl_CallWhenDeleted(interp, proc, clientData) Tcl_DontCallWhenDeleted(interp, proc, clientData)ArgumentsTcl_Interp *interp (in) Interpreter with which to associated callback. Tcl_InterpDeleteProc *proc (in) Procedure to call when interp is deleted. ClientData clientData (in) Arbitrary one-word value to pass to proc. DescriptionTcl_CallWhenDeleted arranges for proc to be called by Tcl_DeleteInterp…

Tcl_DoWhenIdle, Tcl_CancelIdleCall – invoke a procedure when there are no pending events Synopsis#include <tcl.h> Tcl_DoWhenIdle(proc, clientData) Tcl_CancelIdleCall(proc, clientData)ArgumentsTcl_IdleProc *proc (in) Procedure to invoke. ClientData clientData (in) Arbitrary one-word value to pass to proc. DescriptionTcl_DoWhenIdle arranges for proc to be invoked when the application becomes idle. The application is considered to be idle when Tcl_DoOneEvent has…

Tcl_DoOneEvent – wait for events and invoke event handlers Synopsis#include <tcl.h> int Tcl_DoOneEvent(flags)Argumentsint flags (in) This parameter is normally zero. It may be an OR-ed combination of any of the following flag bits: TCL_WINDOW_EVENTS, TCL_FILE_EVENTS, TCL_TIMER_EVENTS, TCL_IDLE_EVENTS, TCL_ALL_EVENTS, or TCL_DONT_WAIT. DescriptionThis procedure is the entry point to Tcl’s event loop; it is responsible for waiting…

Tcl_SaveInterpState, Tcl_RestoreInterpState, Tcl_DiscardInterpState, Tcl_SaveResult, Tcl_RestoreResult, Tcl_DiscardResult – save and restore an interpreter’s state Synopsis#include <tcl.h> Tcl_InterpState Tcl_SaveInterpState(interp, status) int Tcl_RestoreInterpState(interp, state) Tcl_DiscardInterpState(state) Tcl_SaveResult(interp, savedPtr) Tcl_RestoreResult(interp, savedPtr) Tcl_DiscardResult(savedPtr)ArgumentsTcl_Interp *interp (in) Interpreter for which state should be saved. int status (in) Return code value to save as part of interpreter state. Tcl_InterpState state (in) Saved state token…

Tcl_SaveInterpState, Tcl_RestoreInterpState, Tcl_DiscardInterpState, Tcl_SaveResult, Tcl_RestoreResult, Tcl_DiscardResult – save and restore an interpreter’s state Synopsis#include <tcl.h> Tcl_InterpState Tcl_SaveInterpState(interp, status) int Tcl_RestoreInterpState(interp, state) Tcl_DiscardInterpState(state) Tcl_SaveResult(interp, savedPtr) Tcl_RestoreResult(interp, savedPtr) Tcl_DiscardResult(savedPtr)ArgumentsTcl_Interp *interp (in) Interpreter for which state should be saved. int status (in) Return code value to save as part of interpreter state. Tcl_InterpState state (in) Saved state token…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_NewDictObj, Tcl_DictObjPut, Tcl_DictObjGet, Tcl_DictObjRemove, Tcl_DictObjSize, Tcl_DictObjFirst, Tcl_DictObjNext, Tcl_DictObjDone, Tcl_DictObjPutKeyList, Tcl_DictObjRemoveKeyList – manipulate Tcl objects as dictionaries Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewDictObj() int Tcl_DictObjGet(interp, dictPtr, keyPtr, valuePtrPtr) int Tcl_DictObjPut(interp, dictPtr, keyPtr, valuePtr) int Tcl_DictObjRemove(interp, dictPtr, keyPtr) int Tcl_DictObjSize(interp, dictPtr, sizePtr) int Tcl_DictObjFirst(interp, dictPtr, searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjNext(searchPtr, keyPtrPtr, valuePtrPtr, donePtr) void Tcl_DictObjDone(searchPtr) int Tcl_DictObjPutKeyList(interp,…

Tcl_DetachPids, Tcl_ReapDetachedProcs, Tcl_WaitPid – manage child processes in background Synopsis#include <tcl.h> Tcl_DetachPids(numPids, pidPtr) Tcl_ReapDetachedProcs() Tcl_Pid Tcl_WaitPid(pid, statusPtr, options)Argumentsint numPids (in) Number of process ids contained in the array pointed to by pidPtr. int *pidPtr (in) Address of array containing numPids process ids. Tcl_Pid pid (in) The id of the process (pipe) to wait for. int…

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

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)ArgumentsTcl_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 0 is specified….

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)Argumentsint 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 previously created timer…

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)Argumentsint status (in) Provides information about why the application or thread exited. Exact meaning may be platform-specific. 0 usually means…

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