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>