com doc/zh: Sync with en: language/control-structures/return.xml
| From: | Dai Jie | Date: | Sun, 17 Jan 2021 13:00:15 +0000 |
| Subject: | com doc/zh: Sync with en: language/control-structures/return.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-5922@lists.php.net to get a copy of this message | ||
Commit: 8815d45165fff3b32d24fbce04851f84ada484c6
Author: daijie <daijie@php.net> 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>