______________________________________________________________________________
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 手 冊 頁 翻 譯 計 劃 》 :
跋
本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh