com doc/zh: sync to en.: reference/array/functions/current.xml

Commit:    a1844e74347c844f48c66b6eb63fa28efdf7863c
Author:    Bole Chen <[email protected]>         Wed, 27 Jan 2021 17:41:33 +0800
Parents:   6b35592a90301c4fff2093118d9024f5c50db664
Branches:  master

Link:       http://git.php.net/?p=doc/zh.git;a=commitdiff;h=a1844e74347c844f48c66b6eb63fa28efdf7863c

Log:
sync to en.

Changed paths:
  M  reference/array/functions/current.xml


Diff:
diff --git a/reference/array/functions/current.xml b/reference/array/functions/current.xml
index 7eea21f9..92c8c482 100755
--- a/reference/array/functions/current.xml
+++ b/reference/array/functions/current.xml
@@ -1,24 +1,22 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
 <!-- $Author$ -->
-<!-- EN-Revision: 89a73e348c5d4bdd0300996566c672035745e2b0 Maintainer: dallas Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: avenger Status: ready -->
   <refentry xml:id="function.current" xmlns="http://docbook.org/ns/docbook">
    <refnamediv>
     <refname>current</refname>
-    <refpurpose>返回数组中的当前单元</refpurpose>
+    <refpurpose>返回数组中的当前值</refpurpose>
    </refnamediv>
-   
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>mixed</type><methodname>current</methodname>
-   <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+   <methodparam><type class="union"><type>array</type><type>object</type></type><parameter>array</parameter></methodparam>
   </methodsynopsis>
     <para>
-     每个数组中都有一个内部的指针指向它“当前的”单元，初始指向插入到数组中的第一个单元。
+     每个数组中都有一个内部的指针指向它“当前的”单元，初始化时会指向该数组中的第一个值。
     </para>
    </refsect1>
-   
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -27,7 +25,7 @@
      <term><parameter>array</parameter></term>
      <listitem>
       <para>
-       这个数组。
+       要操作的数组。
       </para>
      </listitem>
     </varlistentry>
@@ -37,16 +35,40 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   <function>current</function> 函数返回当前被内部指针指向的数组单元的值，并不移动指针。如果内部指针指向超出了单元列表的末端，<function>current</function>
-     返回 &false;。
+   <function>current</function>
+   函数返回当前被内部指针指向的数组单元的值，并不移动指针。如果内部指针指向超出了单元列表的末端，<function>current</function>
+   将返回 &false;。
   </para>
   &return.falseproblem;
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        <parameter>array</parameter> 参数始终通过赋值来传递。之前的版本中，默认通过引用来传值。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title>使用  <function>current</function> 系列函数的例子</title>
+    <title> <function>current</function> 函数使用示例</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -73,9 +95,15 @@ var_dump(current($arr)); // array(0) { }
   &reftitle.notes;
   <note>
    <simpara>
-    如果数组包含 <type>boolean</type> &false; 的单元则本函数在碰到这个单元时也返回
-       &false;，使得不可能判断是否到了此数组列表的末端。
-    要正确遍历可能含有空单元的数组，用 <function>each</function> 函数。
+    在一个空数组上使用 <function>current</function>
+    函数，和在一个内部指针指向单元末端以外的数组上使用此函数，结果是相同的，同样都会返回
+    <type>bool</type> &false;。如果希望正确遍历一个包含 &false; 的数组，请参阅
+    <function>foreach</function> 函数。
+   </simpara>
+   <simpara>
+    如果仍然希望使用 <function>current</function> 来判断数组单元真实的值，应该同时使用
+    <function>key</function> 和 <function>current</function>
+    来检查当前元素是否为 &null;。
    </simpara>
   </note>
  </refsect1>
@@ -91,10 +119,8 @@ var_dump(current($arr)); // array(0) { }
     <member><function>next</function></member>
    </simplelist>
   </para>
- </refsect1>  
-  
-  </refentry>
-
+ </refsect1>
+</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml