NAME

       upvar - 建立到在不同棧楨上的變量的連接

總覽 SYNOPSIS

       upvar ?level? otherVar myVar ?otherVar myVar ...?
_________________________________________________________________

描述 DESCRIPTION

       這個命令安排在當前過程中的一個或多個局部變量去引用位於包圍它的過程調用中的變量或引用全局變
       量。 Level 可以用 uplevel 命令允許的任何形式，並且如果第一個 otherVar  的第一個字母不是  #
       或一個數字，則可以被省略(它缺省爲1)。對於每個 otherVar 參數，upvar 使由 level 給出的過程楨
       中(如果 level 是 #0 則在全局層次)的叫這個名字的變量在當前過程中可以用由相應的 myVar 參數給
       出名字來訪問。在調用它的時候叫做  otherVar 的變量不需要存在；可以在第一次引用 myVar 時象普
       通變量那樣建立它。在調用 upvar 的時候一定不能存在一個叫 myVar 的變量。MyVar 總是被作爲一個
       變量的名字來對待，而不是一個數組的元素。即使這個名字看起來象一個數組元素，比如  a(b)，仍建
       立一個正規的變量。OtherVar 可以引用一個標量變量，或一個數組元素。Upvar 返回一個空串。

       upvar  命令簡化了傳名調用(call-by-name)過程的實現並使它易於建立如同   Tcl   過程的新控制結
       構。例如，考慮下列過程:
              proc add2 name {
                upvar $name x
                set x [expr $x+2]
              }
       調用   Add2   時加上給出一個變量名字的一個參數，它向這個變量的值加二。儘管  add2  可以使用
       uplevel 替代 upvar 來實現，upvar 簡便了 add2 訪問在調用者過程楨中的變量。

       namespace eval 是改變 Tcl 命令上下文的另一種方式(除了過程調用之外)。它向棧增加一個調用楨來
       表示名字空間上下文。這意味着每個 namespace eval 命令被視爲給 uplevel 和 upvar 命令的另一個
       調用層次。例如，info  level   1   將返回描述一個命令的列表，它要麼是最外的過程要麼是最外的
       namespace  eval  命令。還有，uplevel #0 在最外面的名字空間(全局名字空間)中的頂層求值一個腳
       本。

       如果刪除(unset)一個 upvar 變量(比如，上面的 add2 中的 x )，則 unset 操作影響它所連接到的變 │
       量，而不是 upvar 變量。除了退出在其中定義它的那個過程之外，沒有方法刪除一個 upvar 變量。但 │
       是，可以通過執行另一個 upvar 命令來爲一個 upvar 變量重定目標(retarget)。                   │

Traces 和 upvar                                                                                   │
       upvar  以一種直接但可能不是預期的方式與  trace  交互。如果在  otherVar  上定義了一個變量跟 │
       蹤，涉及   myVar   的動作將觸發這個追蹤。但是，傳遞給跟蹤過程將是   myVar   的名字，而不是 │
       otherVar 的名字。 所以，下列代碼的輸出將是 localVar 而不是 originalVar:                    │
              proc traceproc { name index op } {                                                  │
                puts $name                                                                        │
              }                                                                                   │
              proc setByUpvar { name value } {                                                    │
                upvar $name localVar                                                              │
                set localVar $value                                                               │
              }                                                                                   │
              set originalVar 1                                                                   │
              trace variable originalVar w traceproc                                              │
              setByUpvar originalVar 2                                                            │
              }                                                                                   │

       如果 otherVar 引用一個數組的元素，則爲整個數組設置的變量跟蹤在 myVar  被訪問的時候將不被調 │
       用(但在特定元素上的跟蹤仍將被調用)。特別的，如果這個數組是  env，則對 myVar 的變動將不被正 │
       確的傳遞給子進程。                                                                         │

參見 SEE ALSO

       global(n), namespace(n), uplevel(n), variable(n)

關鍵字 KEYWORDS

       context, frame, global, level, namespace, procedure, variable

[中文版維護人]

       寒蟬退士

[中文版最新更新]

       2001/11/21

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

       http://cmpp.linuxforum.net

跋

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh