Linux Manuals session 3

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_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_GetStdChannel, Tcl_SetStdChannel – procedures for retrieving and replacing the standard channels Synopsis#include <tcl.h> Tcl_Channel Tcl_GetStdChannel(type) Tcl_SetStdChannel(channel, type)Argumentsint type (in) The identifier for the standard channel to retrieve or modify. Must be one of TCL_STDIN, TCL_STDOUT, or TCL_STDERR. Tcl_Channel channel (in) The channel to use as the new value for the specified standard channel. DescriptionTcl defines…

Tcl_Main, Tcl_SetStartupScript, Tcl_GetStartupScript, Tcl_SetMainLoop – main program, startup script, and event loop definition for Tcl-based applications Synopsis#include <tcl.h> Tcl_Main(argc, argv, appInitProc) Tcl_SetStartupScript(path, encoding) Tcl_Obj * Tcl_GetStartupScript(encodingPtr) Tcl_SetMainLoop(mainLoopProc)Argumentsint argc (in) Number of elements in argv. char *argv[] (in) Array of strings containing command-line arguments. On Windows, when using -DUNICODE, the parameter type changes to wchar_t *….

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)ArgumentsTcl_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 I/O procedures. int…

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_FSRegister, Tcl_FSUnregister, Tcl_FSData, Tcl_FSMountsChanged, Tcl_FSGetFileSystemForPath, Tcl_FSGetPathType, Tcl_FSCopyFile, Tcl_FSCopyDirectory, Tcl_FSCreateDirectory, Tcl_FSDeleteFile, Tcl_FSRemoveDirectory, Tcl_FSRenameFile, Tcl_FSListVolumes, Tcl_FSEvalFile, Tcl_FSEvalFileEx, Tcl_FSLoadFile, Tcl_FSUnloadFile, Tcl_FSMatchInDirectory, Tcl_FSLink, Tcl_FSLstat, Tcl_FSUtime, Tcl_FSFileAttrsGet, Tcl_FSFileAttrsSet, Tcl_FSFileAttrStrings, Tcl_FSStat, Tcl_FSAccess, Tcl_FSOpenFileChannel, Tcl_FSGetCwd, Tcl_FSChdir, Tcl_FSPathSeparator, Tcl_FSJoinPath, Tcl_FSSplitPath, Tcl_FSEqualPaths, Tcl_FSGetNormalizedPath, Tcl_FSJoinToPath, Tcl_FSConvertToPathType, Tcl_FSGetInternalRep, Tcl_FSGetTranslatedPath, Tcl_FSGetTranslatedStringPath, Tcl_FSNewNativePath, Tcl_FSGetNativePath, Tcl_FSFileSystemInfo, Tcl_GetAccessTimeFromStat, Tcl_GetBlockSizeFromStat, Tcl_GetBlocksFromStat, Tcl_GetChangeTimeFromStat, Tcl_GetDeviceTypeFromStat, Tcl_GetFSDeviceFromStat, Tcl_GetFSInodeFromStat, Tcl_GetGroupIdFromStat, Tcl_GetLinkCountFromStat, Tcl_GetModeFromStat, Tcl_GetModificationTimeFromStat, Tcl_GetSizeFromStat, Tcl_GetUserIdFromStat,…

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_GetReturnOptions, Tcl_SetReturnOptions, Tcl_AddErrorInfo, Tcl_AppendObjToErrorInfo, Tcl_AddObjErrorInfo, Tcl_SetObjErrorCode, Tcl_SetErrorCode, Tcl_SetErrorCodeVA, Tcl_PosixError, Tcl_LogCommandInfo – retrieve or record information about errors and other return options Synopsis#include <tcl.h> Tcl_Obj * Tcl_GetReturnOptions(interp, code) int Tcl_SetReturnOptions(interp, options) Tcl_AddErrorInfo(interp, message) Tcl_AppendObjToErrorInfo(interp, objPtr) Tcl_AddObjErrorInfo(interp, message, length) Tcl_SetObjErrorCode(interp, errorObjPtr) Tcl_SetErrorCode(interp, element, element, … (char *) NULL) Tcl_SetErrorCodeVA(interp, argList) const char * Tcl_PosixError(interp) void Tcl_LogCommandInfo(interp, script,…

Tcl_RegExpMatch, Tcl_RegExpCompile, Tcl_RegExpExec, Tcl_RegExpRange, Tcl_GetRegExpFromObj, Tcl_RegExpMatchObj, Tcl_RegExpExecObj, Tcl_RegExpGetInfo – Pattern matching with regular expressions Synopsis#include <tcl.h> int Tcl_RegExpMatchObj(interp, textObj, patObj) int Tcl_RegExpMatch(interp, text, pattern) Tcl_RegExp Tcl_RegExpCompile(interp, pattern) int Tcl_RegExpExec(interp, regexp, text, start) void Tcl_RegExpRange(regexp, index, startPtr, endPtr) Tcl_RegExp Tcl_GetRegExpFromObj(interp, patObj, cflags) int Tcl_RegExpExecObj(interp, regexp, textObj, offset, nmatches, eflags) void Tcl_RegExpGetInfo(regexp, infoPtr)ArgumentsTcl_Interp *interp (in) Tcl interpreter…

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_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)Argumentsconst 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 path elements in…

Tcl_GetOpenFile – Return a FILE* for a channel registered in the given interpreter (Unix only) Synopsis#include <tcl.h> int Tcl_GetOpenFile(interp, chanID, write, checkUsage, filePtr)ArgumentsTcl_Interp *interp (in) Tcl interpreter from which file handle is to be obtained. const char *chanID (in) String identifying channel, such as stdin or file4. int write (in) Non-zero means the file will…

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_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_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_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_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_SetObjResult, Tcl_GetObjResult, Tcl_SetResult, Tcl_GetStringResult, Tcl_AppendResult, Tcl_AppendResultVA, Tcl_AppendElement, Tcl_ResetResult, Tcl_FreeResult – manipulate Tcl result Synopsis#include <tcl.h> Tcl_SetObjResult(interp, objPtr) Tcl_Obj * Tcl_GetObjResult(interp) Tcl_SetResult(interp, result, freeProc) const char * Tcl_GetStringResult(interp) Tcl_AppendResult(interp, result, result, … , (char *) NULL) Tcl_AppendResultVA(interp, argList) Tcl_AppendElement(interp, element) Tcl_ResetResult(interp) Tcl_FreeResult(interp)ArgumentsTcl_Interp *interp (out) Interpreter whose result is to be modified or read. Tcl_Obj *objPtr (in)…