'''namespace import''' ''?-'''''force'''''? ?pattern pattern ...?''

Imports commands into a namespace. Each ''pattern'' is a qualified name like '''foo::x''' or '''a::p*'''. That is, it includes the name of an exporting namespace and may have glob-style special characters in the command name at the end of the qualified name. Glob characters may not appear in a namespace name. All the commands that match a ''pattern'' string and which are currently exported from their namespace are added to the current namespace. This is done by creating a new command in the current namespace that points to the exported command in its original namespace; when the new imported command is called, it invokes the exported command. This command normally returns an error if an imported command conflicts with an existing command. However, if the -'''force''' option is given, imported commands will silently replace existing commands. The '''namespace import''' command has snapshot semantics: that is, only requested commands that are currently defined in the exporting namespace are imported. In other words, you can import only the commands that are in a namespace at the time when the '''namespace import''' command is executed. If another command is defined and exported in this namespace later on, it will not be imported.

----

See also:

   * [namespace]
   * [namespace export]

----

[Category Command] -
[Tcl syntax help]