Linux Manuals session 3

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_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) int…

Tcl_CreateEnsemble, Tcl_FindEnsemble, Tcl_GetEnsembleFlags, Tcl_GetEnsembleMappingDict, Tcl_GetEnsembleNamespace, Tcl_GetEnsembleUnknownHandler, Tcl_GetEnsembleSubcommandList, Tcl_IsEnsemble, Tcl_SetEnsembleFlags, Tcl_SetEnsembleMappingDict, Tcl_SetEnsembleSubcommandList, Tcl_SetEnsembleUnknownHandler – manipulate ensemble commands Synopsis#include <tcl.h> Tcl_Command Tcl_CreateEnsemble(interp, name, namespacePtr, ensFlags) Tcl_Command Tcl_FindEnsemble(interp, cmdNameObj, flags) int Tcl_IsEnsemble(token) int Tcl_GetEnsembleFlags(interp, token, ensFlagsPtr) int Tcl_SetEnsembleFlags(interp, token, ensFlags) int Tcl_GetEnsembleMappingDict(interp, token, dictObjPtr) int Tcl_SetEnsembleMappingDict(interp, token, dictObj) int Tcl_GetEnsembleSubcommandList(interp, token, listObjPtr) int Tcl_SetEnsembleSubcommandList(interp, token, listObj) int Tcl_GetEnsembleUnknownHandler(interp,…

Tcl_GetEncoding, Tcl_FreeEncoding, Tcl_GetEncodingFromObj, Tcl_ExternalToUtfDString, Tcl_ExternalToUtf, Tcl_UtfToExternalDString, Tcl_UtfToExternal, Tcl_WinTCharToUtf, Tcl_WinUtfToTChar, Tcl_GetEncodingName, Tcl_SetSystemEncoding, Tcl_GetEncodingNameFromEnvironment, Tcl_GetEncodingNames, Tcl_CreateEncoding, Tcl_GetEncodingSearchPath, Tcl_SetEncodingSearchPath, Tcl_GetDefaultEncodingDir, Tcl_SetDefaultEncodingDir – procedures for creating and using encodings Synopsis#include <tcl.h> Tcl_Encoding Tcl_GetEncoding(interp, name) void Tcl_FreeEncoding(encoding) int Tcl_GetEncodingFromObj(interp, objPtr, encodingPtr) char * Tcl_ExternalToUtfDString(encoding, src, srcLen, dstPtr) char * Tcl_UtfToExternalDString(encoding, src, srcLen, dstPtr) int Tcl_ExternalToUtf(interp, encoding, src, srcLen, flags, statePtr,…

Tcl_CreateCommand – implement new commands in C Synopsis#include <tcl.h> Tcl_Command Tcl_CreateCommand(interp, cmdName, proc, clientData, deleteProc)ArgumentsTcl_Interp *interp (in) Interpreter in which to create new command. const char *cmdName (in) Name of command. Tcl_CmdProc *proc (in) Implementation of new command: proc will be called whenever cmdName is invoked as a command. ClientData clientData (in) Arbitrary one-word value…

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)ArgumentsTcl_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 proc. DescriptionTcl_CreateCloseHandler arranges…

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)ArgumentsTcl_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 zero value to…

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

Tcl_IsSafe, Tcl_MakeSafe, Tcl_CreateSlave, Tcl_GetSlave, Tcl_GetMaster, Tcl_GetInterpPath, Tcl_CreateAlias, Tcl_CreateAliasObj, Tcl_GetAlias, Tcl_GetAliasObj, Tcl_ExposeCommand, Tcl_HideCommand – manage multiple Tcl interpreters, aliases and hidden commands Synopsis#include <tcl.h> int Tcl_IsSafe(interp) int Tcl_MakeSafe(interp) Tcl_Interp * Tcl_CreateSlave(interp, slaveName, isSafe) Tcl_Interp * Tcl_GetSlave(interp, slaveName) Tcl_Interp * Tcl_GetMaster(interp) int Tcl_GetInterpPath(askingInterp, slaveInterp) int Tcl_CreateAlias(slaveInterp, slaveCmd, targetInterp, targetCmd, argc, argv) int Tcl_CreateAliasObj(slaveInterp, slaveCmd, targetInterp, targetCmd, objc,…

Tcl_IsSafe, Tcl_MakeSafe, Tcl_CreateSlave, Tcl_GetSlave, Tcl_GetMaster, Tcl_GetInterpPath, Tcl_CreateAlias, Tcl_CreateAliasObj, Tcl_GetAlias, Tcl_GetAliasObj, Tcl_ExposeCommand, Tcl_HideCommand – manage multiple Tcl interpreters, aliases and hidden commands Synopsis#include <tcl.h> int Tcl_IsSafe(interp) int Tcl_MakeSafe(interp) Tcl_Interp * Tcl_CreateSlave(interp, slaveName, isSafe) Tcl_Interp * Tcl_GetSlave(interp, slaveName) Tcl_Interp * Tcl_GetMaster(interp) int Tcl_GetInterpPath(askingInterp, slaveInterp) int Tcl_CreateAlias(slaveInterp, slaveCmd, targetInterp, targetCmd, argc, argv) int Tcl_CreateAliasObj(slaveInterp, slaveCmd, targetInterp, targetCmd, objc,…

Tcl_ClassGetMetadata, Tcl_ClassSetMetadata, Tcl_CopyObjectInstance, Tcl_GetClassAsObject, Tcl_GetObjectAsClass, Tcl_GetObjectCommand, Tcl_GetObjectFromObj, Tcl_GetObjectName, Tcl_GetObjectNamespace, Tcl_NewObjectInstance, Tcl_ObjectDeleted, Tcl_ObjectGetMetadata, Tcl_ObjectGetMethodNameMapper, Tcl_ObjectSetMetadata, Tcl_ObjectSetMethodNameMapper – manipulate objects and classes Synopsis#include <tclOO.h> Tcl_Object Tcl_GetObjectFromObj(interp, objPtr) Tcl_Object Tcl_GetClassAsObject(class) Tcl_Class Tcl_GetObjectAsClass(object) Tcl_Obj * Tcl_GetObjectName(interp, object) Tcl_Command Tcl_GetObjectCommand(object) Tcl_Namespace * Tcl_GetObjectNamespace(object) Tcl_Object Tcl_NewObjectInstance(interp, class, name, nsName, objc, objv, skip) Tcl_Object Tcl_CopyObjectInstance(interp, object, name, nsName) int Tcl_ObjectDeleted(object) ClientData Tcl_ObjectGetMetadata(object,…

Tcl_RegisterObjType, Tcl_GetObjType, Tcl_AppendAllObjTypes, Tcl_ConvertToType – manipulate Tcl object types Synopsis#include <tcl.h> Tcl_RegisterObjType(typePtr) Tcl_ObjType * Tcl_GetObjType(typeName) int Tcl_AppendAllObjTypes(interp, objPtr) int Tcl_ConvertToType(interp, objPtr, typePtr)ArgumentsTcl_ObjType *typePtr (in) Points to the structure containing information about the Tcl object type. This storage must live forever, typically by being statically allocated. const char *typeName (in) The name of a Tcl object…

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)ArgumentsTcl_Interp *interp (out) Interpreter to use for error reporting. If NULL, then no error message is left. char *list…

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)ArgumentsTcl_Interp *interp (out) Interpreter to use for error reporting. If NULL, then no error message is left. char *list…

Tcl_ConditionNotify, Tcl_ConditionWait, Tcl_ConditionFinalize, Tcl_GetThreadData, Tcl_MutexLock, Tcl_MutexUnlock, Tcl_MutexFinalize, Tcl_CreateThread, Tcl_JoinThread – Tcl thread support Synopsis#include <tcl.h> void Tcl_ConditionNotify(condPtr) void Tcl_ConditionWait(condPtr, mutexPtr, timePtr) void Tcl_ConditionFinalize(condPtr) Void * Tcl_GetThreadData(keyPtr, size) void Tcl_MutexLock(mutexPtr) void Tcl_MutexUnlock(mutexPtr) void Tcl_MutexFinalize(mutexPtr) int Tcl_CreateThread(idPtr, threadProc, clientData, stackSize, flags) int Tcl_JoinThread(id, result)ArgumentsTcl_Condition *condPtr (in) A condition variable, which must be associated with a mutex lock….

Tcl_ConditionNotify, Tcl_ConditionWait, Tcl_ConditionFinalize, Tcl_GetThreadData, Tcl_MutexLock, Tcl_MutexUnlock, Tcl_MutexFinalize, Tcl_CreateThread, Tcl_JoinThread – Tcl thread support Synopsis#include <tcl.h> void Tcl_ConditionNotify(condPtr) void Tcl_ConditionWait(condPtr, mutexPtr, timePtr) void Tcl_ConditionFinalize(condPtr) Void * Tcl_GetThreadData(keyPtr, size) void Tcl_MutexLock(mutexPtr) void Tcl_MutexUnlock(mutexPtr) void Tcl_MutexFinalize(mutexPtr) int Tcl_CreateThread(idPtr, threadProc, clientData, stackSize, flags) int Tcl_JoinThread(id, result)ArgumentsTcl_Condition *condPtr (in) A condition variable, which must be associated with a mutex lock….

Tcl_ConditionNotify, Tcl_ConditionWait, Tcl_ConditionFinalize, Tcl_GetThreadData, Tcl_MutexLock, Tcl_MutexUnlock, Tcl_MutexFinalize, Tcl_CreateThread, Tcl_JoinThread – Tcl thread support Synopsis#include <tcl.h> void Tcl_ConditionNotify(condPtr) void Tcl_ConditionWait(condPtr, mutexPtr, timePtr) void Tcl_ConditionFinalize(condPtr) Void * Tcl_GetThreadData(keyPtr, size) void Tcl_MutexLock(mutexPtr) void Tcl_MutexUnlock(mutexPtr) void Tcl_MutexFinalize(mutexPtr) int Tcl_CreateThread(idPtr, threadProc, clientData, stackSize, flags) int Tcl_JoinThread(id, result)ArgumentsTcl_Condition *condPtr (in) A condition variable, which must be associated with a mutex lock….

Tcl_NewStringObj, Tcl_NewUnicodeObj, Tcl_SetStringObj, Tcl_SetUnicodeObj, Tcl_GetStringFromObj, Tcl_GetString, Tcl_GetUnicodeFromObj, Tcl_GetUnicode, Tcl_GetUniChar, Tcl_GetCharLength, Tcl_GetRange, Tcl_AppendToObj, Tcl_AppendUnicodeToObj, Tcl_AppendObjToObj, Tcl_AppendStringsToObj, Tcl_AppendStringsToObjVA, Tcl_AppendLimitedToObj, Tcl_Format, Tcl_AppendFormatToObj, Tcl_ObjPrintf, Tcl_AppendPrintfToObj, Tcl_SetObjLength, Tcl_AttemptSetObjLength, Tcl_ConcatObj – manipulate Tcl objects as strings Synopsis#include <tcl.h> Tcl_Obj * Tcl_NewStringObj(bytes, length) Tcl_Obj * Tcl_NewUnicodeObj(unicode, numChars) void Tcl_SetStringObj(objPtr, bytes, length) void Tcl_SetUnicodeObj(objPtr, unicode, numChars) char * Tcl_GetStringFromObj(objPtr, lengthPtr) char * Tcl_GetString(objPtr)…

Tcl_Concat – concatenate a collection of strings Synopsis#include <tcl.h> const char * Tcl_Concat(argc, argv)Argumentsint argc (in) Number of strings. const char *const argv[] (in) Array of strings to concatenate. Must have argc entries. DescriptionTcl_Concat is a utility procedure used by several of the Tcl commands. Given a collection of strings, it concatenates them together into…

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)ArgumentsTcl_Interp *interp (in) Interpreter containing the command. const char *cmdName (in) Name of command. int flags (in) OR’ed collection of the values TCL_TRACE_RENAME and TCL_TRACE_DELETE….