______________________________________________________________________________
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