com doc/zh: sync to en: Named Arguments are also supported.: language/functions.xml

Commit:    f1c8c67a35baeef096321ed451a0dd82d266e9b8=0AAuthor:    Bole Chen =
<[email protected]>         Tue, 16 Feb 2021 11:49:43 +0800=0AParents:   f0a2=
727026ca31e274d5c48b0dbbed4cbc05d11e=0ABranches:  master=0A=0ALink:       h=
ttp://git.php.net/?p=3Ddoc/zh.git;a=3Dcommitdiff;h=3Df1c8c67a35baeef096321e=
d451a0dd82d266e9b8=0A=0ALog:=0Async to en: Named Arguments are also support=
ed.=0A=0AChanged paths:=0A  M  language/functions.xml=0A=0A=0ADiff:=0Adiff =
--git a/language/functions.xml b/language/functions.xml=0Aindex 990ff875..d=
c4a1d22 100644=0A--- a/language/functions.xml=0A+++ b/language/functions.xm=
l=0A@@ -1,7 +1,7 @@=0A <?xml version=3D"1.0" encoding=3D"utf-8"?>=0A <!-- $=
Revision$ -->=0A <!-- $Author$ -->=0A-<!-- EN-Revision: 4f04bd50ed71039b89e=
2b9a5aba7e53e74cac4c6 Maintainer: avenger Status: ready -->=0A+<!-- EN-Revi=
sion: ae956cd678e63a4c5c47d9aa23f68ac552581a09 Maintainer: avenger Status: =
ready -->=0A <!-- CREDITS: Gregory, dallas -->=0A <chapter xml:id=3D"langua=
ge.functions" xmlns=3D"http://docbook.org/ns/docbook">=0A   <title>=
=E5=87=BD=E6=95=B0</title>=0A@@ -123,7 +123,8 @@ bar();=0A    <simpara>=0A =
    PHP =E7=9A=84=E5=87=BD=E6=95=B0=E6=94=AF=E6=8C=81 <link linkend=3D"func=
tions.variable-arg-list">=E5=8F=AF=E5=8F=98=E6=95=B0=E9=87=8F=E7=9A=84=
=E5=8F=82=E6=95=B0</link> =E5=92=8C=0A     <link linkend=3D"functions.argum=
ents.default">=E9=BB=98=E8=AE=A4=E5=8F=82=E6=95=B0</link>=E3=80=82=E5=8F=
=82=E8=A7=81=0A-    <function>func_num_args</function>=EF=BC=8C<function>fu=
nc_get_arg</function> =E5=92=8C <function>func_get_args</function>=E3=80=
=82=0A+    <function>func_num_args</function>=EF=BC=8C<function>func_get_ar=
g</function> =E5=92=8C=0A+    <function>func_get_args</function>=E3=80=
=82=0A    </simpara>=0A =0A    <para>=0A@@ -164,8 +165,9 @@ function recurs=
ion($a)=0A    <para>=0A     PHP =E6=94=AF=E6=8C=81=E6=8C=89=E5=80=BC=
=E4=BC=A0=E9=80=92=E5=8F=82=E6=95=B0=EF=BC=88=E9=BB=98=E8=AE=A4=EF=BC=89=
=EF=BC=8C<link=0A     linkend=3D"functions.arguments.by-reference">=
=E9=80=9A=E8=BF=87=E5=BC=95=E7=94=A8=E4=BC=A0=E9=80=92=E5=8F=82=E6=95=B0</l=
ink> =E4=BB=A5=E5=8F=8A <link=0A-    linkend=3D"functions.arguments.default=
">=E9=BB=98=E8=AE=A4=E5=8F=82=E6=95=B0</link>=E3=80=82=E4=B9=9F=E6=94=AF=
=E6=8C=81 <link=0A-    linkend=3D"functions.variable-arg-list">=E5=8F=AF=
=E5=8F=98=E9=95=BF=E5=BA=A6=E5=8F=82=E6=95=B0=E5=88=97=E8=A1=A8</link>=
=E3=80=82=0A+    linkend=3D"functions.arguments.default">=E9=BB=98=E8=AE=
=A4=E5=8F=82=E6=95=B0</link>=E3=80=82=E4=B9=9F=E6=94=AF=E6=8C=81=0A+    <li=
nk linkend=3D"functions.variable-arg-list">=E5=8F=AF=E5=8F=98=E9=95=BF=
=E5=BA=A6=E5=8F=82=E6=95=B0=E5=88=97=E8=A1=A8</link> =E5=92=8C=0A+    <link=
 linkend=3D"functions.named-arguments">=E5=91=BD=E5=90=8D=E5=8F=82=E6=95=
=B0</link>=E3=80=82=0A    </para>=0A    <para>=0A     <example>=0A@@ -422,8=
 +424,8 @@ echo sum(1, 2, 3, 4);=0A =0A     <para>=0A     =E4=B9=9F=
=E5=8F=AF=E4=BB=A5=E4=BD=BF=E7=94=A8 <literal>...</literal> =E8=AF=AD=
=E6=B3=95=E6=9D=A5=E4=BC=A0=E9=80=92 <type>array</type> =E6=88=96=0A-     <=
classname>Traversable</classname> =E5=81=9A=E4=B8=BA=E5=8F=82=E6=95=B0=
=E5=88=B0=E5=87=BD=E6=95=B0=E4=B8=AD=EF=BC=9A=0A-=0A+     <classname>Traver=
sable</classname>=0A+     =E5=81=9A=E4=B8=BA=E5=8F=82=E6=95=B0=E5=88=B0=
=E5=87=BD=E6=95=B0=E4=B8=AD=EF=BC=9A=0A =0A      <example>=0A       <title>=
=E4=BD=BF=E7=94=A8 <literal>...</literal> =E6=9D=A5=E4=BC=A0=E9=80=92=
=E5=8F=82=E6=95=B0</title>=0A@@ -544,25 +546,18 @@ echo sum(1, 2, 3, 4);=0A=
    </sect2>=0A =0A    <sect2 xml:id=3D"functions.named-arguments">=0A-    =
<title>Named Arguments</title>=0A+    <title>=E5=91=BD=E5=90=8D=E5=8F=82=
=E6=95=B0</title>=0A =0A     <para>=0A-     PHP 8.0.0 introduced named argu=
ments as an extension of the existing=0A-     positional parameters. Named =
arguments allow passing arguments to a=0A-     function based on the parame=
ter name, rather than the parameter position.=0A-     This makes the meanin=
g of the argument self-documenting, makes the=0A-     arguments order-indep=
endent and allows skipping default values arbitrarily.=0A+     PHP 8.0.0 =
=E5=BC=80=E5=A7=8B=E5=BC=95=E5=85=A5=E4=BA=86=E5=91=BD=E5=90=8D=E5=8F=82=
=E6=95=B0=E4=BD=9C=E4=B8=BA=E7=8E=B0=E6=9C=89=E4=BD=8D=E7=BD=AE=E5=8F=82=
=E6=95=B0=E7=9A=84=E6=89=A9=E5=B1=95=E3=80=82=E5=91=BD=E5=90=8D=E5=8F=82=
=E6=95=B0=E5=85=81=E8=AE=B8=E6=A0=B9=E6=8D=AE=E5=8F=82=E6=95=B0=E5=90=8D=
=E8=80=8C=E4=B8=8D=E6=98=AF=E5=8F=82=E6=95=B0=E4=BD=8D=E7=BD=AE=E5=90=91=
=E5=87=BD=E6=95=B0=E4=BC=A0=E5=8F=82=E3=80=82=E8=BF=99=E4=BD=BF=E5=BE=97=
=E5=8F=82=E6=95=B0=E7=9A=84=E5=90=AB=E4=B9=89=E8=87=AA=E6=88=90=E4=BD=93=
=E7=B3=BB=EF=BC=8C=E5=8F=82=E6=95=B0=E4=B8=8E=E9=A1=BA=E5=BA=8F=E6=97=A0=
=E5=85=B3=EF=BC=8C=E5=B9=B6=E5=85=81=E8=AE=B8=E4=BB=BB=E6=84=8F=E8=B7=B3=
=E8=BF=87=E9=BB=98=E8=AE=A4=E5=80=BC=E3=80=82=0A     </para>=0A =0A     <pa=
ra>=0A-     Named arguments are passed by prefixing the value with the para=
meter name=0A-     followed by a colon. Using reserved keywords as paramete=
r names is allowed.=0A-     The parameter name must be an identifier, speci=
fying dynamically=0A-     is not allowed.=0A+     =E5=91=BD=E5=90=8D=
=E5=8F=82=E6=95=B0=E9=80=9A=E8=BF=87=E5=9C=A8=E5=8F=82=E6=95=B0=E5=90=8D=
=E5=89=8D=E5=8A=A0=E4=B8=8A=E5=86=92=E5=8F=B7=E6=9D=A5=E4=BC=A0=E9=80=92=
=E3=80=82=E5=85=81=E8=AE=B8=E4=BD=BF=E7=94=A8=E4=BF=9D=E7=95=99=E5=85=B3=
=E9=94=AE=E5=AD=97=E4=BD=9C=E4=B8=BA=E5=8F=82=E6=95=B0=E5=90=8D=E3=80=82=
=E5=8F=82=E6=95=B0=E5=90=8D=E5=BF=85=E9=A1=BB=E6=98=AF=E4=B8=80=E4=B8=AA=
=E6=A0=87=E8=AF=86=E7=AC=A6=EF=BC=8C=E4=B8=8D=E5=85=81=E8=AE=B8=E5=8A=A8=
=E6=80=81=E6=8C=87=E5=AE=9A=E3=80=82=0A     </para>=0A =0A     <example>=0A=
-     <title>Named argument syntax</title>=0A+     <title>=E5=91=BD=
=E5=90=8D=E5=8F=82=E6=95=B0=E7=9A=84=E8=AF=AD=E6=B3=95</title>=0A      <pro=
gramlisting role=3D"php">=0A       <![CDATA[=0A <?php=0A@@ -577,14 +572,14 =
@@ function_name($variableStoringParamName: $value);=0A     </example>=0A =
=0A     <example>=0A-     <title>Positional arguments versus named argument=
s</title>=0A+     <title>=E9=80=9A=E8=BF=87=E4=BD=8D=E7=BD=AE=E4=BC=A0=
=E5=8F=82=E4=B8=8E=E5=91=BD=E5=90=8D=E5=8F=82=E6=95=B0=E7=9A=84=E5=AF=B9=
=E6=AF=94</title>=0A      <programlisting role=3D"php">=0A       <![CDATA[=
=0A <?php=0A-// Using positional arguments:=0A+// =E4=BD=BF=E7=94=A8=
=E9=A1=BA=E5=BA=8F=E4=BC=A0=E9=80=92=E5=8F=82=E6=95=B0=EF=BC=9A=0A array_fi=
ll(0, 100, 50);=0A =0A-// Using named arguments:=0A+// =E4=BD=BF=E7=94=
=A8=E5=91=BD=E5=90=8D=E5=8F=82=E6=95=B0=EF=BC=9A=0A array_fill(start_index:=
 0, count: 100, value: 50);=0A ?>=0A ]]>=0A@@ -592,11 +587,11 @@ array_fill=
(start_index: 0, count: 100, value: 50);=0A     </example>=0A =0A     <para=
>=0A-     The order in which the named arguments are passed does not matter=
.=0A+     =E6=8C=87=E5=AE=9A=E5=8F=82=E6=95=B0=E7=9A=84=E4=BC=A0=E9=80=
=92=E9=A1=BA=E5=BA=8F=E5=B9=B6=E4=B8=8D=E9=87=8D=E8=A6=81=E3=80=82=0A     <=
/para>=0A =0A     <example>=0A-     <title>Same example as above with a dif=
ferent order of parameters</title>=0A+     <title>=E5=8F=82=E6=95=B0=
=E9=A1=BA=E5=BA=8F=E4=B8=8D=E5=90=8C=E7=9A=84=E7=A4=BA=E4=BE=8B=EF=BC=88=
=E5=90=8C=E4=B8=8A=E4=BE=8B=EF=BC=89</title>=0A      <programlisting role=
=3D"php">=0A       <![CDATA[=0A <?php=0A@@ -607,19 +602,16 @@ array_fill(va=
lue: 50, num: 100, start_index: 0);=0A     </example>=0A =0A     <para>=0A-=
     Named arguments can be combined with positional arguments. In this cas=
e,=0A-     the named arguments must come after the positional arguments.=0A=
-     It is also possible to specify only some of the optional arguments of=
 a=0A-     function, regardless of their order.=0A+     =E5=91=BD=E5=90=
=8D=E5=8F=82=E6=95=B0=E4=B9=9F=E5=8F=AF=E4=BB=A5=E4=B8=8E=E4=BD=8D=E7=BD=
=AE=E5=8F=82=E6=95=B0=E7=9B=B8=E7=BB=93=E5=90=88=E4=BD=BF=E7=94=A8=E3=80=
=82=E6=AD=A4=E7=A7=8D=E6=83=85=E5=86=B5=E4=B8=8B=EF=BC=8C=E5=91=BD=E5=90=
=8D=E5=8F=82=E6=95=B0=E5=BF=85=E9=A1=BB=E5=9C=A8=E4=BD=8D=E7=BD=AE=E5=8F=
=82=E6=95=B0=E4=B9=8B=E5=90=8E=E3=80=82=E4=B9=9F=E5=8F=AF=E4=BB=A5=E5=8F=
=AA=E6=8C=87=E5=AE=9A=E4=B8=80=E4=B8=AA=E5=87=BD=E6=95=B0=E7=9A=84=E9=83=
=A8=E5=88=86=E5=8F=AF=E9=80=89=E5=8F=82=E6=95=B0=EF=BC=8C=E8=80=8C=E4=B8=
=8D=E8=80=83=E8=99=91=E5=AE=83=E4=BB=AC=E7=9A=84=E9=A1=BA=E5=BA=8F=E3=80=
=82=0A     </para>=0A =0A     <example>=0A-     <title>Combining named argu=
ments with positional arguments</title>=0A+     <title>=E5=91=BD=E5=90=
=8D=E5=8F=82=E6=95=B0=E4=B8=8E=E4=BD=8D=E7=BD=AE=E5=8F=82=E6=95=B0=E7=BB=
=93=E5=90=88=E4=BD=BF=E7=94=A8</title>=0A      <programlisting role=3D"php"=
>=0A       <![CDATA[=0A <?php=0A htmlspecialchars($string, double_encode: f=
alse);=0A-// Same as=0A+// =E7=AD=89=E4=BB=B7=E4=BA=8E=0A htmlspecialchars(=
$string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false);=0A ?>=0A ]]>=0A@@ -656,=
6 +648,7 @@ foo(1, param: 2);=0A     =E5=80=BC=E9=80=9A=E8=BF=87=E4=BD=
=BF=E7=94=A8=E5=8F=AF=E9=80=89=E7=9A=84=E8=BF=94=E5=9B=9E=E8=AF=AD=E5=8F=
=A5=E8=BF=94=E5=9B=9E=E3=80=82=E5=8F=AF=E4=BB=A5=E8=BF=94=E5=9B=9E=E5=8C=
=85=E6=8B=AC=E6=95=B0=E7=BB=84=E5=92=8C=E5=AF=B9=E8=B1=A1=E7=9A=84=E4=BB=
=BB=E6=84=8F=E7=B1=BB=E5=9E=8B=E3=80=82=E8=BF=94=E5=9B=9E=E8=AF=AD=E5=8F=
=A5=E4=BC=9A=E7=AB=8B=E5=8D=B3=E4=B8=AD=E6=AD=A2=E5=87=BD=E6=95=B0=E7=9A=
=84=E8=BF=90=E8=A1=8C=EF=BC=8C=E5=B9=B6=E4=B8=94=E5=B0=86=E6=8E=A7=E5=88=
=B6=E6=9D=83=E4=BA=A4=E5=9B=9E=E8=B0=83=E7=94=A8=E8=AF=A5=E5=87=BD=E6=95=
=B0=E7=9A=84=E4=BB=A3=E7=A0=81=E8=A1=8C=E3=80=82=E6=9B=B4=E5=A4=9A=E4=BF=
=A1=E6=81=AF=E8=A7=81=0A     <function>return</function>=E3=80=82=0A    </p=
ara>=0A+=0A    <note>=0A     <para>=0A      =E5=A6=82=E6=9E=9C=E7=9C=81=
=E7=95=A5=E4=BA=86=0A@@ -722,7 +715,8 @@ $newref =3D& returns_reference();=
=0A      </example>=0A     </para>=0A     <simpara>=0A-    =E6=9C=89=
=E5=85=B3=E5=BC=95=E7=94=A8=E7=9A=84=E6=9B=B4=E5=A4=9A=E4=BF=A1=E6=81=AF, =
=E8=AF=B7=E6=9F=A5=E7=9C=8B <link linkend=3D"language.references">=E5=BC=
=95=E7=94=A8=E7=9A=84=E8=A7=A3=E9=87=8A</link>=E3=80=82=0A+    =E6=9C=89=
=E5=85=B3=E5=BC=95=E7=94=A8=E7=9A=84=E6=9B=B4=E5=A4=9A=E4=BF=A1=E6=81=AF, =
=E8=AF=B7=E6=9F=A5=E7=9C=8B <link=0A+     linkend=3D"language.references">=
=E5=BC=95=E7=94=A8=E7=9A=84=E8=A7=A3=E9=87=8A</link>=E3=80=82=0A    </simpa=
ra>=0A    </sect2>=0A   </sect1>=0A@@ -1392,6 +1386,7 @@ var_export($x);  /=
/ =E8=BE=93=E5=87=BA 1=0A     </note>=0A    </sect2>=0A   </sect1>=0A+=0A  =
</chapter>=0A =0A <!-- Keep this comment at the end of the file=0A