NAME¶

總覽 SYNOPSIS¶

描述 DESCRIPTION¶

namespace children ?namespace? ?pattern?

返回屬於名字空間 namespace 的所有子名字空間的一個列表。如果未指定 namespace，則返回當前名字空間的所有子名字空間。這個命令返回完全限制的(fully-qualified)的名字，它們以 :: 開始。如果給出了可選的 pattern ，則這個命令只返回匹配通配符式樣模式的名字。確定實際使用的模式如下: 以 :: 開始的模式直接使用，否則把命令空間 namespace (或當前名字空間的完全限制的名字) 加在這個模式的前面。

namespace code script

為以後執行稿本 script 而捕獲(Capture)當前的名字空間上下文。它返回一個新稿本，在這個結果稿本中 script 被包裹在一個 namespace inscope 命令中。新稿本有兩個重要的特性。首先，它可以在任何名字空間中被求值，而導致 script 在當前的名字空間(調用 namespace code命令的那個名字空間)中被求值。其次，可以向結果稿本添加補充的參數 並且它們將被作為補充參數而傳遞給 script 。例如，假設在名字空間 ::a::b 中調用命令set script [namespace code {foo bar}]。則可以在任何名字空間中執行 eval "$script x y" (假定 script 的值已經被正確的傳遞進來) 而與命令 namespace eval ::a::b {foo bar x y} 有相同的效果。這個命令是必須有的，因為像 Tk 這樣的擴展一般在全局名字空間中執行回調稿本。一個有作用域的(scoped)命令把一個命令和它的名字空間上下文一起捕獲，在這種方式下就能在以後正確的執行它。如何使用這個命令建立回調稿本的例子參見 SCOPED VALUES (有作用域的值)章節。

namespace current

返回給當前名字空間的完全限定的名字。全局名字空間的實際的名字是「」(一個空串)，但這個命令為了編程者的方便而為全局名字空間返回 ::。

namespace delete ?namespace namespace ...?

刪除所有的名字空間 namespace 和這些名字空間包含的所有變量、過程、和子名字空間。如果在名字空間中一個過程正在執行，在這個過程返回之前這個過程保持存在；但是，會標記這個名字空間來防止其他代碼通過名字查找它。如果一個名字空間不存在，這個命令返回一個錯誤。如果未給出名字空間名字，這個命令什麼也不做。

namespace eval namespace arg ?arg ...?

激活叫 namespace 的名字空間並在這個上下文中對某些稿本進行求值。如果這個名字空間不存在，則建立它。如果指定了多於一個 arg 參數，則用與 eval命令一樣的方式把這些參數串聯起來並用空格彼此分隔，並對結果進行求值。

 

 

如果 namespace 有前導的名字空間限定符並且有的前導名字空間不存在，則自動建立它們。

namespace export ?-clear? ?pattern pattern ...?

指定從一個名字空間中導出那些命令。導出的那些命令以後可以被其他名字空間用 namespace import 命令導入。在一個名字空間中定義的命令和這個名字空間以前導入的命令二者都可以被這個名字空間導出。在執行 namespace export 命令的時候，這些(要導出的)命令不是必須已經被定義了。每個 pattern 可以包含通配符式樣的特殊字符，但不可以包含任何名字空間限定符。就是說，模式只能指定在當前(導出)的名字空間中的命令。把所有 pattern 添加到這個名字空間的導出模式列表上。如果給出了 - clear 標誌，則在添加任何 pattern 參數之前，重置這個名字空間的導出模式列表為空。如果未給出 patterns 並且未給出 -clear標誌，這個命令返回這個名字空間當前的導出列表。

namespace forget ?pattern pattern ...?

刪除以前從一個名字空間導入的命令。所有 pattern 都是一個限定的命令如 foo::x 或 a::b::p*。限定的名字包含 ::並且用一個或多個名字空間的名字限制一個名字。每個 pattern 被一個導出名字空間的名字所限制，並且在限定的名字的結束處可以有通配符式樣的特殊字符。通配字符可以不出現在名字空間的名字中。這個命令首先查找匹配的導出命令。接著檢查是否有些命令是以前由當前名字空間導入的。如果有，這個命令刪除相應的導入的命令。效果上，這個命令撤消 namespace import命令的動作。

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

導入命令到一個名字空間中。所有 pattern都是一個限定的命令如foo::x 或 a::p*。就是說，它包括一個導出名字空間的名字，並且在限定的名字的結束處可以有通配符式樣的特殊字符。通配字符可以不出現在名字空間的名字中。把所有匹配某個 pattern 字符串並且被它們的名字空間導出的命令添加到當前名字空間中。這是通過在當前名字空間中建立一個新命令，這個新命令指向在它的原始名字空間中的導出命令；當調用這個新導入的命令的時候，它調用那個導出的命令。如果一個導入的命令與一個現存的命令有沖突，則這個命令通常返回一個錯誤。但是，如果給出了 - force 選項，在則導入命令將悄無聲息的替換現存的命令。 namespace import 命令有當前快照(snapshot)語義: 就是說，在要求(導入)的命令中，只導入在導出的名字空間中定義了的那些命令。換句話說，你只能導入在執行 namespace import 的時候在一個名字空間中(已經存在)的命令。如果此後又定義並導出了其他命令，則不會導入它們。

namespace inscope namespace arg ?arg ...?

在一個特定的名字空間的上下文中執行一個稿本。不希望編程者直接執行這個命令；例如，在應用使用 namespace code命令建立回調稿本，並且應用接著要向 Tk組件注冊它的時候，隱式的生成對它的調用。除了有 lappend語義並且名字空間必須已經存在之外，namespace inscope命令與 namespace eval 命令非常相似。它把第一個參數作為一個列表來對待，接著把後面的所有參數作為適當的列表元素添加到第一個參數的尾部。 namespace inscope ::foo a x y z 等價於namespace eval ::foo [concat a [list x y z]]。這個 lappend>語義很重要，因為許多回調 稿本實際上是前綴。

namespace origin command

返回導入的命令 command所引用的原始命令的完全限定的名字。當一個命令被導入一個名字空間的時候，在這個名字空間中建立一個新命令，它指向在導出名字空間中的實際命令。如果一個命令被導入到一個名字空間的序列 a, b,...,n 之中，這裏每一個後續的名字空間只從前面的名字空間中導入命令，這個命令返回在第一個名字空間中的原始命令的完全限定的名字 a。如果 command不引用一個導入的命令，返回這個( command)命令自己的完全限定的名字。

namespace parent ?namespace?

返回給名字空間 namespace 的父名字空間的完全限定的名字。如果未指定 namespace，返回當前名字空間的父名字空間的完全限定的命令。

namespace qualifiers string

返回給 string 的所有前導的名字空間限定符。限定符是由 ::分隔的名字空間的名字。對於 string ::foo::bar::x，這個命令返回 ::foo::bar，而對於 ::它返回一個空串。這個命令與 namespace tail 命令互補。注意，它不檢查名字空間的名字事實上是否是目前定義的名字空間的名字。

namespace tail string

返回在一個限定的字符串尾部的簡單名字。限定符是由 ::分隔的名字空間的名字。對於 string ::foo::bar::x，這個命令返回 x，而對於 ::它返回一個空串。這個命令與 namespace qualifiers命令互補。它不檢查名字空間的名字事實上是否是目前定義的名字空間的名字。

namespace which ?-command? ?-variable? name

把 name 作為一個命令或者變量來查找並返回它的完全限定的名字。例如，如果 name 在當前名字空間中不存在但在全局名字空間中存在，這個命令返回在全局名字空間中的一個完全限定的名字。如果這個命令或變量不存在，這個命令返回空串。如果變量已經建立但未被定義，比如通過 variable 命令或通過在變量上 trace(進行追蹤)，這個命令返回這個變量的完全限定的名字。如果未給出標誌，name被作為一個命令的名字。關於名字解析的規則的解釋請參見下面的NAME RESOLUTION (名字解析)章節。

 

什麼名字空間 WHAT IS A NAMESPACE?¶

namespace eval Counter {
    namespace export bump
    variable num 0

    proc bump {} {
        variable num
        incr num
    }
}

namespace eval Counter {
    variable num 0
    proc bump {} {
        variable num
        return [incr num]
    }
}
namespace eval Counter {
    proc test {args} {
        return $args
    }
}
namespace eval Counter {
    rename test ""
}

限定的名字 QUALIFIED NAMES¶

Counter::bump 5
Counter::Reset

puts "count = $Counter::num"

Foo::Counter::bump 3

proc Foo::Test {args} {return $args}

rename Foo::Test Bar::Test

NAME¶

set traceLevel 0
namespace eval Debug {
    printTrace $traceLevel
}

set traceLevel 0
namespace eval Foo {
    variable traceLevel 3

    namespace eval Debug {
        printTrace $traceLevel
    }
}

namespace eval Foo::Debug {namespace which -variable traceLevel}

namespace eval Foo {namespace which -variable traceLevel}

導入命令 IMPORTING COMMANDS¶

Blt::graph .g -background red
Blt::table . .g 0,0

namespace import Blt::*

graph .g -background red
table . .g 0,0

namespace import Blt::graph Blt::table

namespace import -force Blt::graph Blt::table

namespace forget Blt::*

rename Blt::graph ""

導出命令 EXPORTING COMMANDS¶

namespace eval Counter {
    namespace export bump reset
    variable Num 0
    variable Max 100

    proc bump {{by 1}} {
        variable Num
        incr Num $by
        Check
        return $Num
    }
    proc reset {} {
        variable Num
        set Num 0
    }
    proc Check {} {
        variable Num
        variable Max
        if {$Num > $Max} {
            error "too high!"
        }
    }
}

namespace import Counter::*

參見 SEE ALSO¶

關鍵字 KEYWORDS¶

[中文版維護人]¶

[中文版最新更新]¶

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