Scroll to navigation

return(3tcl) Tcl Built-In Commands return(3tcl) 





NAME


return -
    从一个过程中返回






总览 SYNOPSIS


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










描述 DESCRIPTION


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








异常返回 EXCEPTIONAL RETURNS


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



  

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

  

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

  

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

  

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

  

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

  

  
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






跋


本页面中文版由中文
    man 手册页计划提供。
  

  中文 man
    手册页计划：https://github.com/man-pages-zh/manpages-zh







  

    7.0
    Tcl