Manpages

______________________________________________________________________________

NAME

return - 从 一 个 过 程 中 返 回

总 览 SYNOPSIS

return ?-code code? ?-errorinfo info? ?-errorcode code? ?string? _________________________________________________________________

描 述 DESCRIPTION

从 当 前 过 程 (或 顶 层 命 令 或 source 命 令 )中 立 即 返 回 , 用 string 作 为 返 回 值 。 如 果 未 指 定 string, 则 返 回 一 个 空 串 作 为 结 果 。

异 常 返 回 EXCEPTIONAL RETURNS

通 常 在 未 指 定 -code 选 项 的 情 况 下 , 过 程 将 正 常 返 回 (它 的 完 成 代 码 是 TCL_OK)。 但 是 , 可 以 使 用 -code 选 项 来 生 成 一 个 异 常 的 过 程 返 回 。 Code 可 以 是 某 个 下 列 值 :

ok 正 常 返 回 : 如 同 这 个 选 项 被 省 略 。

error 错 误 返 回 : 除 了

errorInfoerrorCode 变 量 的 处 理 之 外 , 同 于 使 用 error 命 令 终 止 过 程 (见 后 )。

return 返 回 当 前 过 程 并 加 上 一 个

TCL_RETURN 完 成 代 码 , 这 将 导 致 调 用 它 的

那 个 过 程 也 返 回 。

break 返 回 当 前 过 程 并 加 上 一 个

TCL_BREAK 完 成 代 码 , 它 将 终 止 调 用 当 前

过 程 的 代 码 中 的 最 内 层 嵌 套 循 环 。

continue 返 回 当 前 过 程 并 加 上 一 个

TCL_CONTINUE 完 成 代 码 , 它 终 止 调 用 当 前

过 程 的 代 码 中 的 最 内 层 嵌 套 循 环 的 当 前 重 复 操 作 。

value

Value 必 须 是 一 个 整 数 ; 把 它 作 为 当 前 过 程 的 完 成 代 码 返 回 。

很 少 使 用 -code 选 项 。 提 供 它 目 的 让 实 现 新 控 制 结 构 的 命 令 可 以 向 它 的 调 用 者 反 映 异 常 条 件 。 两 个 补 充 的 选 项 , -errorinfo-errorcode, 可 以 被 用 来 在 错 误 返 回 期 间 提 供 补 充 信 息 。 除 非 codeerror, 否 则 忽 略 这 些 选 项 。

-errorinfo 选 项 为 errorInfo 变 量 指 定 一 个 初 始 栈 跟 踪 ; 如 果 未 指 定 它 , 则 留 在 errorInfo 中 的 栈 跟 踪 将 包 括 对 这 个 过 程 的 调 用 和 栈 上 的 更 高 层 次 , 但 不 包 括 有 关 过 程 中 错 误 上 下 文 的 任 何 信 息 。 典 型 的 , 在 catch 命 令 在 这 个 过 程 中 捕 获 到 一 个 错 误 之 后 , 把 留 在 errorInfo 中 的 值 提 供 为 info 值 。 如 果 指 定 了 -errorcode 选 项 , 则 codeerrorCode 变 量 提 供 一 个 值 。 如 果 未 指 定 这 个 选 项 , 则 errorCode 缺 省 为 NONE

参 见 SEE ALSO

break(n), continue(n), error(n), proc(n)

关 键 字 KEYWORDS

break, continue, error, procedure, return

[中 文 版 维 护 人 ]

寒 蝉 退 士

[中 文 版 最 新 更 新 ]

2001/06/21

《 中 国 Linux 论 坛 man 手 册 页 翻 译 计 划 》 :

http://cmpp.linuxforum.net

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh