return(3tcl)

NAME
return - 从一个过程中返回

总览 SYNOPSIS
return ?-code code? ?-errorinfo info? ?-errorcode code? ?string?

描述 DESCRIPTION

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

异常返回 EXCEPTIONAL RETURNS

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

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

error
    错误返回: 除了 errorInfo 和 errorCode 变量的处理之外，同于使用 error 命令终止过程(见后)。

return
    返回当前过程并加上一个 TCL_RETURN 完成代码，这将导致调用它的那个过程也返回。

break
    返回当前过程并加上一个 TCL_BREAK 完成代码，它将终止调用当前过程的代码中的最内层嵌套循环。

continue
    返回当前过程并加上一个 TCL_CONTINUE 完成代码，它终止调用当前过程的代码中的最内层嵌套循环的当前重复操作。

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

很少使用 -code 选项。提供它目的让实现新控制结构的命令可以向它的调用者反映异常条件。

两个补充的选项，-errorinfo 和 -errorcode，可以被用来在错误返回期间提供补充信息。除非 code 是 error，否则忽略这些选项。

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

如果指定了 -errorcode 选项，则 code 为 errorCode 变量提供一个值。如果未指定这个选项，则 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