{"id":7261,"date":"2022-12-20T19:36:02","date_gmt":"2022-12-20T22:36:02","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/tcl_namespace-man3-4\/"},"modified":"2022-12-20T19:36:02","modified_gmt":"2022-12-20T22:36:02","slug":"tcl_namespace-man3-4","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/tcl_namespace-man3-4\/","title":{"rendered":"Tcl_Namespace (man3)"},"content":{"rendered":"

Tcl_Namespace<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
ARGUMENTS<\/a>
DESCRIPTION<\/a>
SEE ALSO<\/a>
KEYWORDS<\/a> <\/p>\n

\n

______________________________________________________________________________<\/p>\n

NAME <\/a> <\/h2>\n

Tcl_AppendExportList, Tcl_CreateNamespace, Tcl_DeleteNamespace, Tcl_Export, Tcl_FindCommand, Tcl_FindNamespace, Tcl_ForgetImport, Tcl_GetCurrentNamespace, Tcl_GetGlobalNamespace, Tcl_GetNamespaceUnknownHandler, Tcl_Import, Tcl_SetNamespaceUnknownHandler \u2212 manipulate namespaces<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

#include <\/b><\/p>\n

Tcl_Namespace bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_CreateNamespace<\/b>(interp, name, clientData, deleteProc<\/i>)<\/p>\n

Tcl_DeleteNamespace<\/b>(nsPtr<\/i>)<\/p>\n

int
Tcl_AppendExportList<\/b>(interp, nsPtr, objPtr<\/i>)<\/p>\n

int
Tcl_Export<\/b>(interp, nsPtr, pattern, resetListFirst<\/i>)<\/p>\n

int
Tcl_Import<\/b>(interp, nsPtr, pattern, allowOverwrite<\/i>)<\/p>\n

int
Tcl_ForgetImport<\/b>(interp, nsPtr, pattern<\/i>)<\/p>\n

Tcl_Namespace bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_GetCurrentNamespace<\/b>(interp<\/i>)<\/p>\n

Tcl_Namespace bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_GetGlobalNamespace<\/b>(interp<\/i>)<\/p>\n

Tcl_Namespace bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_FindNamespace<\/b>(interp, name, contextNsPtr, flags<\/i>)<\/p>\n

Tcl_Command
Tcl_FindCommand<\/b>(interp, name, contextNsPtr, flags<\/i>)<\/p>\n

Tcl_Obj bodies manpages.csv script_extrae_body.sh script.sh usr
Tcl_GetNamespaceUnknownHandler(<\/b>interp, nsPtr<\/i>)<\/p>\n

int
Tcl_SetNamespaceUnknownHandler(<\/b>interp, nsPtr, handlerPtr<\/i>)<\/p>\n

ARGUMENTS <\/a> <\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
<\/td>\n\n

Tcl_Interp *interp<\/i> (in\/out)<\/p>\n<\/td>\n

<\/td>\n\n

The interpreter in which the namespace exists and where name lookups are performed. Also where error result messages are written.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

const char *name<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

The name of the namespace or command to be created or accessed.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

ClientData clientData<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

A context pointer by the creator of the namespace. Not interpreted by Tcl at all.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_NamespaceDeleteProc *deleteProc<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

A pointer to function to call when the namespace is deleted, or NULL if no such callback is to be performed.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_Namespace *nsPtr<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

The namespace to be manipulated, or NULL (for other than Tcl_DeleteNamespace<\/b>) to manipulate the current namespace.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_Obj *objPtr<\/i> (out)<\/p>\n<\/td>\n

<\/td>\n\n

A reference to an unshared value to which the function output will be written.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

const char *pattern<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

The glob-style pattern (see Tcl_StringMatch<\/b>) that describes the commands to be imported or exported.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

int resetListFirst<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Whether the list of export patterns should be reset before adding the current pattern to it.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

int allowOverwrite<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

Whether new commands created by this import action can overwrite existing commands.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_Namespace *contextNsPtr<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

The location in the namespace hierarchy where the search for a namespace or command should be conducted relative to when the search term is not rooted at the global namespace. NULL indicates the current namespace.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

int flags<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

OR-ed combination of bits controlling how the search is to be performed. The following flags are supported: TCL_GLOBAL_ONLY<\/b> (indicates that the search is always to be conducted relative to the global namespace), TCL_NAMESPACE_ONLY<\/b> (just for Tcl_FindCommand<\/b>; indicates that the search is always to be conducted relative to the context namespace), and TCL_LEAVE_ERR_MSG<\/b> (indicates that an error message should be left in the interpreter if the search fails.)<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Tcl_Obj *handlerPtr<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

A script fragment to be installed as the unknown command handler for the namespace, or NULL to reset the handler to its default.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

______________________________________________________________________________<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

Namespaces are hierarchic naming contexts that can contain commands and variables. They also maintain a list of patterns that describes what commands are exported, and can import commands that have been exported by other namespaces. Namespaces can also be manipulated through the Tcl command namespace<\/b>.<\/p>\n

The Tcl_Namespace<\/i> structure encapsulates a namespace, and is guaranteed to have the following fields in it: name<\/i> (the local name of the namespace, with no namespace separator characters in it, with empty denoting the global namespace), fullName<\/i> (the fully specified name of the namespace), clientData<\/i>, deleteProc<\/i> (the values specified in the call to Tcl_CreateNamespace<\/b>), and parentPtr<\/i> (a pointer to the containing namespace, or NULL for the global namespace.)<\/p>\n

Tcl_CreateNamespace<\/b> creates a new namespace. The deleteProc<\/i> will have the following type signature:<\/p>\n

typedef void Tcl_NamespaceDeleteProc<\/b>(
ClientData clientData<\/i>);<\/p>\n

Tcl_DeleteNamespace<\/b> deletes a namespace, calling the deleteProc<\/i> defined for the namespace (if any).<\/p>\n

Tcl_AppendExportList<\/b> retrieves the export patterns for a namespace given namespace and appends them (as list items) to objPtr<\/i>.<\/p>\n

Tcl_Export<\/b> sets and appends to the export patterns for a namespace. Patterns are appended unless the resetListFirst<\/i> flag is true.<\/p>\n

Tcl_Import<\/b> imports commands matching a pattern into a namespace. Note that the pattern must include the name of the namespace to import from. This function returns an error if an attempt to import a command over an existing command is made, unless the allowOverwrite<\/i> flag has been set.<\/p>\n

Tcl_ForgetImport<\/b> removes imports matching a pattern.<\/p>\n

Tcl_GetCurrentNamespace<\/b> returns the current namespace for an interpreter.<\/p>\n

Tcl_GetGlobalNamespace<\/b> returns the global namespace for an interpreter.<\/p>\n

Tcl_FindNamespace<\/b> searches for a namespace named name<\/i> within the context of the namespace contextNsPtr<\/i>. If the namespace cannot be found, NULL is returned.<\/p>\n

Tcl_FindCommand<\/b> searches for a command named name<\/i> within the context of the namespace contextNsPtr<\/i>. If the command cannot be found, NULL is returned.<\/p>\n

Tcl_GetNamespaceUnknownHandler<\/b> returns the unknown command handler for the namespace, or NULL if none is set.<\/p>\n

Tcl_SetNamespaceUnknownHandler<\/b> sets the unknown command handler for the namespace. If handlerPtr<\/i> is NULL, then the handler is reset to its default.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

Tcl_CreateCommand(3), Tcl_ListObjAppendList(3), Tcl_SetVar(3)<\/p>\n

KEYWORDS <\/a> <\/h2>\n

namespace, command<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

Tcl_AppendExportList, Tcl_CreateNamespace, Tcl_DeleteNamespace, Tcl_Export, Tcl_FindCommand, Tcl_FindNamespace, Tcl_ForgetImport, Tcl_GetCurrentNamespace, Tcl_GetGlobalNamespace, Tcl_GetNamespaceUnknownHandler, Tcl_Import, Tcl_SetNamespaceUnknownHandler \u2212 manipulate namespaces <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2536],"tags":[2538,3007,3586],"class_list":["post-7261","post","type-post","status-publish","format-standard","hentry","category-3-llamadas-de-bibliotecas","tag-2538","tag-man3","tag-tcl_import"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7261","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7261"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7261\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7261"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7261"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7261"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}