Return

从函数返回到之前通过函数调用, Hotkey 激活, 或其他方式执行跳转的地方.

Return Expression

参数

Expression

此参数进能在函数中使用.

如果未设置或省略, 默认为空字符串.

当 return 不在函数内使用时, 应该省略此参数.

由于此参数为表达式, 下面所有的例子都是有效的:

return 3
return "literal string"
return MyVar 
return i + 1
return true  ; 返回数字 1 表示 "true".
return ItemCount < MaxItems  ; 返回 true 或 false 值.
return FindColor(TargetColor)

备注

如果表达式用圆括号括起来, 则 Return 后面的空格或制表符是可选的, 如 return(expression).

如果没有调用者可返回, 则 Return 将执行 Exit 作为代替.

在返回值给调用者中描述了多种从函数中返回多个值给调用者的方法.

函数, Exit, ExitApp

示例

报告函数返回的值.

MsgBox returnTest() ; 显示 123

returnTest() {
    return 123
}

第一个 Return 确保如果前面的条件为真, 则跳过后续的函数调用. 第二个 Return 是多余的, 当在这样的函数结尾使用时.

#z::  ; Win-Z
^#z::  ; Ctrl-Win-Z
{
    MsgBox "A Win-Z hotkey was pressed."
    if GetKeyState("Ctrl")
        return  ; 尽早完成, 跳过下面的函数调用.
    MyFunction()
}

MyFunction()
{
    Sleep 1000
    return  ; 像这样在函数末尾使用时, 是多余的.
}
unixetc