'''interp create''' ''?'''''-safe'''''? ?--? ?path?''

Creates a slave interpreter identified by ''path'' and a new command, called a ''slave command''. The name of the slave command is the last component of ''path''. The new slave interpreter and the slave command are created in the interpreter identified by the path obtained by removing the last component from ''path''. For example, if ''path'' is '''a b c''' then a new slave interpreter and slave command named '''c''' are created in the interpreter identified by the path '''a b'''. The slave command may be used to manipulate the new interpreter as described below. If ''path'' is omitted, Tcl creates a unique name of the form '''interp'''''x'', where ''x'' is an integer, and uses it for the interpreter and the slave command. If the '''-safe''' switch is specified (or if the master interpreter is a safe interpreter), the new slave interpreter will be created as a safe interpreter with limited functionality; otherwise the slave will include the full set of Tcl built-in commands and variables. The -- switch can be used to mark the end of switches; it may be needed if ''path'' is an unusual value such as '''-safe'''. The result of the command is the name of the new interpreter. The name of a slave interpreter must be unique among all the slaves for its master; an error occurs if a slave interpreter by the given name already exists in this master. The initial recursion limit of the slave interpreter is set to the current recursion limit of its parent interpreter.

----
Note that [interp create] has to do a lot of processing to find init.tcl and load it, to construct a sensible tcl environment.  This is quite time consuming.  If you need a swifter [interp create] and can live with (very) reduced functionality, use '''-safe''', it's substantially faster:

 puts "Normal interp create: [time {interp create} 40]"
 Normal interp create: 9236.6 microseconds per iteration

compared to:

 puts "Safe interp create :[time {interp create -safe} 40]"
 Safe interp create :967.55 microseconds per iteration



----

See also:

   * [interp]
   * [interp delete]
   * [interp eval]
   * [interp exists]


<<categories>> Command | Tcl syntax help