interp

NAME

總覽 SYNOPSIS

描述 DESCRIPTION

INTERP 命令 COMMAND

interp alias srcPath srcCmd

返回一個 Tcl 列表，它的元素是與叫做 srcCmd的別名有關的 targetCmd 和 args(在建立別名時指定所有這些值；在從直譯器中實際的源命令如果被重新命名的話可能與 srcCmd 不同)。

interp alias srcPath srcCmd {}

刪除在從直譯器中用 srcPath 標識的給 srcCmd 的別名。 srcCmd 引用在其下建立別名的名字；如果 源命令已經被重新命名，則刪除重新命名後的命令。

interp alias srcPath srcCmd targetPath targetCmd ?arg arg ...?

這個命令在一個從直譯器和其他直譯器之間建立一個別名(關於在一個從直譯器和它的主直譯器之間建立別名請參見下面的 alias 從命令)。在這個命令中，兩個從直譯器可以在呼叫這個命令的直譯器底下的直譯器層次中的任何位置。 SrcPath和 srcCmd 標識這個別名的來源。 SrcPath 是一個 Tcl 列表，它的元素選擇一個特定的直譯器。例如，“ a b”標識一個直譯器 b，它是直譯器 a 的一個從直譯器， a直譯器是呼叫(命令)的直譯器的一個從直譯器。一個空列表指定呼叫這個命令的直譯器。 srcCmd給出一個新命令的名字，將在源直譯器中建立它。TargetPath和 targetCmd 指定一個目標直譯器和命令，和 arg 引數，如果有的話，給 targetCmd 指定增補的引數，它們在 srcCmd 呼叫中指定的所有引數的前面。 TargetCmd在這個呼叫的時候可以被取消定義(undefine)了，或者它已經存在了；它不由這個命令來建立。別名安排在源直譯器中呼叫給定源命令的時候在目標直譯器中呼叫給定目標命令。詳情參見下面的 ALIAS INVOCATION (別名呼叫)章節。

interp aliases ?path?

這個命令返回給在用 path 表示的直譯器中定義的別名的所有源命令的名字一個 Tcl 列表。

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

建立用 path 標識的一個從直譯器和叫做從命令( slave command)的一個新命令。從命令的名字是 path的最後一個成員。在其中建立新的從直譯器和從命令的直譯器由從 path 中去除最後一個成員所獲得的路徑來標識。例如，如果 path 是 a b c 則一個新的從直譯器和叫做 c的從命令建立在用路徑 a b 標識的從直譯器中。可以使用從命令先下面描述的那樣操縱新直譯器。如果省略了 path， Tcl 建立 interpx 形式的一個唯一的名字，這裡的 x是一個整數，並用於直譯器和從命令。如果指定了 -safe開關(或者主直譯器是一個安全直譯器)，新的從直譯器將建立成功能有限的一個安全直譯器；否則從直譯器將包含 Tcl 內建命令和變數的全集。使用 -- 開關來標記開關的結束；如果路徑是象 -safe 這樣的一個特殊的值的時候需要這個開關。這個命令的結果是新直譯器的名字。一個從直譯器的名字在它的主直譯器的所有從直譯器中必須是唯一的；如果在這個主直譯器中用給定名字(標識)的一個從直譯器已經存在則發生一個錯誤。

interp delete ?path ...?

刪除用可選的 path 引數給出的零個或多個直譯器，並且對於每個直譯器，它還刪除它的所有從直譯器。這個命令還刪除給每個被刪除的直譯器的從命令。對於每個 path 引數，如果叫這個名字的直譯器不存在，這個名字將引發一個錯誤。

interp eval path arg ?arg ...?

這個命令用與 concat命令相同的方式串聯所有的 arg 引數，接著在用 path 標識的直譯器中把結果字串作為一個 Tcl 指令碼來求值。把這個求值的結果(如果發生錯誤的話，包括象 errorInfo和 errorCode 變數這樣的錯誤資訊)返回給呼叫(命令)的直譯器。

interp exists path

如果在這個主直譯器中存在用 path 指定的從直譯器則返回 1，否則返回 0。如果省略了 path，使用呼叫(命令)的直譯器。

 

interp expose path hiddenName ?exposedCmdName?

在用 path 表示(denote)的直譯器中，使隱藏的命令 hiddenName 暴露(expose)，最終把它帶回在一個新的 exposedCmdName 名字之下(目前只接受沒有任何:: 的一個全域性名字空間名字)。如果有目標名字的一個暴露的命令已經存在，這個命令失敗。隱藏命令的詳情參見下面的HIDDEN COMMANDS (隱藏命令)章節。

interp hide path exposedCmdName ? hiddenCmdName?

在用 path 表示(denote)的直譯器中，使暴露的命令 exposedCmdName 隱藏，並把它重新命名成隱藏命令 hiddenCmdName，如果未給出 hiddenCmdName 則保持相同的名字。如果有目標名字的一個隱藏的命令已經存在，這個命令失敗。目前 exposedCmdName 和 hiddenCmdName二者不能不能包含名字空間限定符，否則將引發一個錯誤。即使當前名字空間不是全域性名字空間，仍在全域性名字空間中查詢要被 interp hide隱藏的命令。這防止從直譯器透過使當前的名字空間不同於全域性名字空間(的方式)，來愚弄主直譯器去隱藏錯誤的命令。隱藏命令的詳情參見下面的HIDDEN COMMANDS (隱藏命令)章節。

interp hidden path

返回在用 path 標識的直譯器中所有隱藏命令的名字的一個列表。

interp invokehidden path ?-global? hiddenCmdName ?arg ...?

在由 path 表示的直譯器中用提供的引數呼叫隱藏命令 hiddenCmdName 。對引數不(進行)替換或求值。如果存在 -global 標誌，在目標直譯器的全域性層次上呼叫隱藏命令；否則在當前的呼叫框架 (frame)上呼叫它並且可以訪問呼叫框架內部和外部的區域性變數。隱藏命令的詳情請參見下面的HIDDEN COMMANDS (隱藏命令)章節。

interp issafe ?path?

如果由 path 指定的直譯器是安全的則返回 1，否則返回 0。

 

interp marktrusted path

標記用 path 標識的直譯器是可信任的。不暴露隱藏命令。這個命令只能在可信任的直譯器中呼叫。如果由 path標識的直譯器已經是可信任的，則這個命令沒有影響。

interp share srcPath channelId destPath

在用 srcPath 標識的直譯器和用 destPath 標識的直譯器之間導致用 channelId標識的 IO 通道變成共享的。兩個直譯器在這個 IO通道上由相同的許可權。兩個直譯器必須關閉它來關閉低層的 IO 通道；在銷燬一個直譯器的時候自動關閉在這個直譯器中可訪問的 IO 通道。

interp slaves ?path?

返回與用 path 標識的直譯器相關的所有從直譯器的名字的一個 Tcl 列表。如果省略了 path，使用呼叫(命令)的直譯器。

interp target path alias

返回描述給一個別名的目標直譯器的一個 Tcl 列表。用一個直譯器路徑和源命令名指定這個別名， 就象在上面的 interp alias 中那樣。目標直譯器的名字被返回為相對於呼叫(命令)的直譯器的一個直譯器路徑。如果給這個別名的目標直譯器是呼叫(命令)的直譯器則返回一個空列表。如果給別名的目標直譯器不是呼叫(命令)的直譯器或是它的後代之一則生成一個錯誤。在呼叫這個命令的時候目標命令不是必須定義的。

interp transfer srcPath channelId destPath

導致用 channelId 標識的 IO 通道，在用 destPath 標識的直譯器中變成可獲得的，而在用 srcPath 標識的直譯器中變成不可獲得的。

SLAVE 命令 COMMAND

slave command ?arg arg ...?

slave aliases

返回一個 Tcl 列表，它的元素是在 slave 中的所有別名的名字。返回的名字是建立別名時使用的 srcCmd 的值(如果它們已經被重新命名，則它可以同這個命令的當前的名字不相同)。

slave alias srcCmd

返回一個 Tcl 列表，它的元素是與叫做 srcCmd 的別名相關的 targetCmd 和 args(在建立這個別名的時候指定所有這些值；在從直譯器中的實際的源命令如果被重命令則可能與 srcCmd不同)。

slave alias srcCmd {}

在從直譯器中刪除給 srcCmd 的別名。srcCmd 參照在其下建立別名的那個名字；如果源命令已經被重新命名，則刪除重新命名後的命令。

slave alias srcCmd targetCmd ?arg ..?

建立一個別名，當在slave 中呼叫 srcCmd 的時候, 在主直譯器中呼叫 targetCmd 。把 arg 引數作為補充的引數傳遞給 targetCmd ，這些引數在 srcCmd 的呼叫中傳遞的任何引數之前。詳情參見下面的ALIAS INVOCATION (別名呼叫)章節。

slave eval arg ?arg ..?

這個命令用與 concat 命令相同的方式串聯所有的 arg 引數，接著在 slave 中把結果字串作為一個 Tcl 指令碼來求值。把這個求值的結果(如果有錯誤發生，包括象 errorInfo 和 errorCode 變數這樣的錯誤資訊)返回給呼叫(命令)的直譯器。

 

slave expose hiddenName ?exposedCmdName?

這個命令暴露在 slave 的隱藏的命令 hiddenName，最終把它帶回在一個新的 exposedCmdName 名字之下(目前只接受沒有任何:: 的一個全域性名字空間名字)。如果有目標名字的一個暴露的命令已經存在，這個命令失敗。隱藏命令的詳情參見下面的HIDDEN COMMANDS (隱藏命令)章節。

slave hide exposedCmdName ?hiddenCmdName?

這個命令隱藏在從直譯器中暴露的命令 exposedCmdName，並把它重新命名成隱藏命令 hiddenCmdName，如果未給出hiddenCmdName 則保持相同的名字。如果有目標名字的一個隱藏的命令已經存在，這個命令失敗。目前 exposedCmdName和 hiddenCmdName二者不能不能包含名字空間限定符，否則將引發一個錯誤。即使當前名字空間不是全域性名字空間，仍在全域性名字空間中查詢要被隱藏的命令。這防止從直譯器透過使當前的名字空間不同於全域性名字空間(的方式)，來愚弄主直譯器去隱藏錯誤的命令。隱藏命令的詳情參見下面的HIDDEN COMMANDS (隱藏命令)章節。

slave hidden

返回在 slave 中所有隱藏的名字的一個列表。

slave invokehidden ?-global hiddenName ? arg ..?

這個命令在 slave 中用提供的引數呼叫隱藏的命令 hiddenName。對這些引數不進行求值或替換。如果給出了 -global標誌，則在這個從直譯器的全域性層次上呼叫這個命令；否則在當前呼叫框架上呼叫它並可訪問這個呼叫框架內部或外部的區域性變數。隱藏命令的詳情參見下面的HIDDEN COMMANDS (隱藏命令)章節。

slave issafe

如果從直譯器是安全的則返回 1，否則返回 0。

 

slave marktrusted

標記從直譯器為可以信任的。只可以被可信任的直譯器呼叫。這個命令不暴露在這個從直譯器中的任何隱含命令。如果這個命令已經是可以信任的了，則這個命令沒有影響。

安全直譯器 SAFE INTERPRETERS

 
after	append	array	binary
break	case	catch	clock
close	concat	continue	eof
error	eval	expr	fblocked
fcopy	fileevent	flush	for
foreach	format	gets	global
history	if	incr	info
interp	join	lappend	lindex
linsert	list	llength	lrange
lreplace	lsearch	lsort	namespace
package	pid	proc	puts
read	regexp	regsub	rename
return	scan	seek	set
split	string	subst	switch
tell	trace	unset	update
uplevel	upvar	variable	vwait
while

 
cd	exec	exit	fconfigure
file	glob	load	open
pwd	socket	source	vwait

別名呼叫 ALIAS INVOCATION

隱藏命令 HIDDEN COMMANDS

感謝 CREDITS

參見 SEE ALSO

關鍵字 KEYWORDS

[中文版維護人]

[中文版最新更新]

《中國 Linux 論壇 man 手冊頁翻譯計劃》:

跋