此特性为Java版独有。
此命令可以被写入一个函数中,以控制函数执行。它可作为其所在函数的结束点,并设定该函数被调用后的返回值为一个整型数值。通过设置返回值为某数值,它可被用于记录带有条件分支的/function
命令的执行结果,以及反映它们随后的执行情况。
语法[]
return <value>
- 终止其所在函数,并设置此命令的返回值为一个整型数值。
参数[]
<value>
:int
- 一个整型数值(-2,147,483,648到2,147,483,647),作为调用其所在函数的返回值。
效果[]
命令 | 触发条件 | Java版 |
---|---|---|
任意 | 参数未正确指定 | 无法解析 |
/return <value> | <value> 超出规定范围(-2,147,483,64到2,147,483,647)或类型非整型 | |
/return run <command> | <command> 命令无法解析 | |
<command> 命令执行失败 | 执行失败 | |
任意 | 执行成功时 | 终止执行,返回特定值作为结果 |
输出[]
命令 | 版本 | 条件 | 成功次数 | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
/return <value> | Java版 | 成功时 | 1 | 1 | value 参数的值 |
失败时 | 0 | 0 | 0 | ||
/return run <command> | 成功时 | 1 | 通过/function 间接调用,输出1,否则无输出 | 通过/function 间接调用,输出<command> 的返回值,否则无输出 | |
失败时 | 0 | 通过/function 间接调用,输出0,否则无输出 | 通过/function 间接调用,输出0,否则无输出 |
示例[]
- 使命令结果为20:
/return 20
历史[]
Java版 | |||||
---|---|---|---|---|---|
1.20 | 23w16a | 加入了/return 。 | |||
1.20.2 | 23w31a | 加入了run 子命令。 | |||
pre1 | 暂时移除了run 子命令。 | ||||
Java版(即将到来) | |||||
1.20.3 | 23w41a | 重新加入了run 子命令。 | |||
23w44a | 加入了fail 子命令。 |
语言