com doc/zh: update array-fill(): reference/array/functions/array-fill.xml

Commit: 8d1fddf6125e6bf352748a47da8b691f597bc37c Author: 蒋文健 <jwjbjg@gmail.com> Fri, 5 Feb 2021 16:25:14 +0800 Committer: daijie <daijie@php.net> Sun, 7 Feb 2021 17:34:40 +0800 Parents: d20b91d4562754fbbc4205d926fc866951d013ce Branches: master Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=8d1fddf6125e6bf352748a47da8b691f597bc37c Log: update array-fill() Changed paths: M reference/array/functions/array-fill.xml Diff: diff --git a/reference/array/functions/array-fill.xml b/reference/array/functions/array-fill.xml index b4b4285b..a49895d2 100755 --- a/reference/array/functions/array-fill.xml +++ b/reference/array/functions/array-fill.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> <!-- $Author$ --> -<!-- EN-Revision: b455daa1c77ecf415cb55be7a594b5ba4603db00 Maintainer: dallas Status: ready --> +<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: dallas Status: ready --> <refentry xml:id="function.array-fill" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>array_fill</refname> @@ -13,72 +13,71 @@ <methodsynopsis> <type>array</type><methodname>array_fill</methodname> <methodparam><type>int</type><parameter>start_index</parameter></methodparam> - <methodparam><type>int</type><parameter>num</parameter></methodparam> + <methodparam><type>int</type><parameter>count</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> - <function>array_fill</function> 用 <parameter>value</parameter> - 参数的值将一个数组填充 <parameter>num</parameter> 个条目，键名由 - <parameter>start_index</parameter> 参数指定的开始。 + 用 <parameter>value</parameter> 参数的值填充 <parameter>count</parameter> 个元素到数组， + 开始键名由 <parameter>start_index</parameter> 参数指定。 </para> - </refsect1> - - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - - <varlistentry> - <term><parameter>start_index</parameter></term> - <listitem> - <para> - 返回的数组的第一个索引值。 - </para> - <para> - 如果 <parameter>start_index</parameter> 是负数， - 那么返回的数组的第一个索引将会是 - <parameter>start_index</parameter> ，而后面索引则从0开始。 - (参见 <link linkend="function.array-fill.example.basic">例子</link>)。 - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><parameter>num</parameter></term> - <listitem> - <para> - 插入元素的数量。 - 必须大于或等于 0。 - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><parameter>value</parameter></term> - <listitem> - <para> - 用来填充的值。 - </para> - </listitem> - </varlistentry> - - </variablelist> - </para> - </refsect1> - - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - 返回填充后的数组。 - </para> - </refsect1> - - <refsect1 role="errors"> - &reftitle.errors; - <para> - 如果 <parameter>num</parameter> 小于零，将会抛出 <constant>E_WARNING</constant>。 - </para> - </refsect1> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + + <varlistentry> + <term><parameter>start_index</parameter></term> + <listitem> + <para> + 返回的数组的第一个索引值。 + </para> + <para> + 如果 <parameter>start_index</parameter> 是负数， + 那么返回的数组的第一个索引将会是 + <parameter>start_index</parameter> ，而后面索引则从0开始。 + (参见 <link linkend="function.array-fill.example.basic">例子</link>)。 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>count</parameter></term> + <listitem> + <para> + 要插入元素的数量。 + 必须大于或等于 0。 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + 用来填充的值。 + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + 返回填充后的数组。 + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + 如果 <parameter>count</parameter> 小于零，将会抛出 <constant>E_WARNING</constant>。 + </para> + </refsect1> <refsect1 role="changelog"> &reftitle.changelog; @@ -95,9 +94,9 @@ <row> <entry>5.6.0</entry> <entry> - <parameter>num</parameter> 现在可以是零。 + <parameter>count</parameter> 现在可以是零。 之前 - <parameter>num</parameter> 必须大于零。 + <parameter>count</parameter> 必须大于零。 </entry> </row> </tbody> @@ -105,13 +104,13 @@ </informaltable> </para> </refsect1> - - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example xml:id="function.array-fill.example.basic"> - <title><function>array_fill</function> 例子</title> - <programlisting role="php"> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example xml:id="function.array-fill.example.basic"> + <title><function>array_fill</function> 例子</title> + <programlisting role="php"> <![CDATA[ <?php $a = array_fill(5, 6, 'banana'); @@ -120,9 +119,9 @@ print_r($a); print_r($b); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -143,28 +142,28 @@ Array ]]> </screen> </example> - </para> - </refsect1> - - <refsect1 role="notes"> - &reftitle.notes; - <para> - 参见手册上 <link linkend="language.types.array">数组</link> 一节里关于负数的键的详细解释。 - </para> - </refsect1> - - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>array_fill_keys</function></member> - <member><function>str_repeat</function></member> - <member><function>range</function></member> - </simplelist> - </para> - </refsect1> -</refentry> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <para> + 参见手册上 <link linkend="language.types.array">数组</link> 一节里关于负数的键的详细解释。 + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>array_fill_keys</function></member> + <member><function>str_repeat</function></member> + <member><function>range</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml