com doc/zh: 更新 array_rand(): refere nce/array/functions/array-rand.xml

Commit: ab675d210ca11f85154c82039a302106cc995291 Author: 蒋文健 <jwjbjg@gmail.com> Tue, 23 Feb 2021 15:20:09 +0800 Committer: daijie <daijie@php.net> Tue, 9 Mar 2021 14:52:24 +0800 Parents: d40476b7e73bc95ba43d4207da3f6050aefcfd44 Branches: master Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=ab675d210ca11f85154c82039a302106cc995291 Log: 更新 array_rand() Changed paths: M reference/array/functions/array-rand.xml Diff: diff --git a/reference/array/functions/array-rand.xml b/reference/array/functions/array-rand.xml index 1fe40353..9ef9edd9 100755 --- a/reference/array/functions/array-rand.xml +++ b/reference/array/functions/array-rand.xml @@ -1,25 +1,23 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: bb8db2ad12cdcae8e151a096749c42aa5c427a20 Maintainer: HonestQiao Status: ready --> +<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: HonestQiao Status: ready --> <refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>array_rand</refname> - <refpurpose> - 从数组中随机取出一个或多个单元 - </refpurpose> - </refnamediv> + <refnamediv> + <refname>array_rand</refname> + <refpurpose>从数组中随机取出一个或多个随机键</refpurpose> + </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>array_rand</methodname> + <methodsynopsis> + <type class="union"><type>int</type><type>string</type><type>array</type></type><methodname>array_rand</methodname> <methodparam><type>array</type><parameter>array</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>num</parameter><initializer>1</initializer></methodparam> - </methodsynopsis> - <para> - 从数组中取出一个或多个随机的单元，并返回随机条目的一个或多个键。 - 它使用了伪随机数产生算法，所以不适合密码学场景， - </para> - </refsect1> + </methodsynopsis> + <para> + 从数组中取出一个或多个随机的单元，并返回随机条目对应的键（一个或多个）。 + 它使用了伪随机数产生算法，所以不适合密码学场景。 + </para> + </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -48,7 +46,7 @@ <para> 如果只取出一个，<function>array_rand</function> 返回随机单元的键名。 - 否则就返回包含随机键名的数组。 + 否则就返回包含随机键名的数组（按照键在原数组中的顺序排列）。 完成后，就可以根据随机的键获取数组的随机值。 取出数量如果超过 array 的长度，就会导致 <constant>E_WARNING</constant> 错误，并返回 NULL。 </para> @@ -68,13 +66,14 @@ <row> <entry>7.1.0</entry> <entry> - <link linkend="migration71.incompatible.rand-srand-aliases">内置的随机数生成算法从 libc rand 函数改成<link xlink:href="&url.mersenne;">梅森旋转</link> 伪随机数生成算法。</link> + 内部随机化算法已从 libc rand 函数<link linkend="migration71.incompatible.rand-srand-aliases">更改为</link>使用 + <link xlink:href="&url.mersenne;">梅森旋转算法（Mersenne Twister）</link> 随机数生成器。 </entry> </row> <row> <entry>5.2.10</entry> <entry> - The resulting array of keys is no longer shuffled. + 生成的随机键名的数组不再被重新排列。 </entry> </row> </tbody> @@ -108,8 +107,7 @@ echo $input[$rand_keys[1]] . "\n"; </simplelist> </para> </refsect1> - </refentry> - +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml