com doc/zh: Sync with en: language/control-structures/return.xml
[email protected] (Dai Jie) Sun, 17 Jan 2021 13:00:15 +0000
| Newsgroups | php.doc.zh |
|---|---|
| Message-ID | <[email protected]> |
Commit: 8815d45165fff3b32d24fbce04851f84ada484c6 Author: daijie <[email protected]> Sun, 17 Jan 2021 21:00:15 +0800 Parents: 97ff4e14eabecf758455a97b5c54f04a338fe489 Branches: master Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=8815d45165fff3b32d24fbce04851f84ada484c6 Log: Sync with en Changed paths: M language/control-structures/return.xml Diff: diff --git a/language/control-structures/return.xml b/language/control-structures/return.xml index b0a17ea8..54d32d62 100644 --- a/language/control-structures/return.xml +++ b/language/control-structures/return.xml @@ -2,12 +2,16 @@ <!-- $Revision$ --> <!-- $Author$ --> <!-- Reviewed: yes Maintainer: dallas --> -<!-- EN-Revision: 84b8fca68fc762fefe85acde180a38b2e77a28b9 Maintainer: dallas Status: ready --> +<!-- EN-Revision: a9a6224ca97531df0a4e4b9b16b59c3f2baf1b09 Maintainer: dallas Status: ready --> <sect1 xml:id="function.return" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>return</title> <?phpdoc print-version-for="return"?> <simpara> + <literal>return</literal> 将程序控制返还给调用模块。 + 将在调用模块中执行的下一句表达式中继续。 + </simpara> + <simpara> 如果在一个函数中调用 <function>return</function> 语句,将立即结束此函数的执行并将它的参数作为函数的值返回。<function>return</function> 也会终止 <function>eval</function> 语句或者脚本文件的执行。 @@ -30,8 +34,7 @@ <note> <simpara> 注意既然 <function>return</function> - 是语言结构而不是函数,因此其参数没有必要用括号将其括起来。通常都不用括号,实际上也应该不用,这样可以降低 - PHP 的负担。 + 是语言结构而不是函数,因此其参数没有必要用括号将其括起来,也不推荐这样用。 </simpara> </note> <note> @@ -40,13 +43,11 @@ <literal>return</literal> 时加上了括号却又没有参数会导致解析错误。 </simpara> </note> - <note> - <simpara> - 当用引用返回值时<emphasis>永远不要</emphasis>使用括号,这样行不通。只能通过引用返回变量,而不是语句的结果。如果使用 - <literal>return ($a);</literal> 时其实不是返回一个变量,而是表达式 - <literal>($a)</literal> 的值(当然,此时该值也正是 <varname>$a</varname> 的值)。 - </simpara> - </note> + </para> + <para> + 自 PHP 7.1.0 起,如果返回类型需要是 <type>void</type> 而带了返回的参数, + 将导致 <constant>E_COMPILE_ERROR</constant>; + 相反返回类型需要而未带参数也会同样导致该错误。 </para> </sect1>