namespace

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 手冊頁翻譯計劃》:

跋