array_rand
从数组中随机取出一个或多个随机键
&reftitle.description;
intstringarrayarray_rand
arrayarray
intnum1
从数组中取出一个或多个随机的单元,并返回随机条目对应的键(一个或多个)。
&caution.cryptographically-insecure;
&reftitle.parameters;
array
输入的数组。
不能为空。
num
指定要取出的单元数量。
必须大于零,且小于或等于 array 的长度。
&reftitle.returnvalues;
如果只取出一个,array_rand
返回随机单元的键名。
否则就返回包含随机键名的数组。
完成后,就可以根据随机的键获取数组的随机值。
如果返回的是包含随机键名的数组,数组单元的顺序按照键名在原数组中的顺序排列。
&reftitle.errors;
如果 array 为空,或者 num 超出范围,
就会抛出一个 ValueError。
&reftitle.changelog;
&Version;
&Description;
8.0.0
如果 num 超出范围,array_rand
现在会抛出一个 ValueError;
之前会抛出一个 E_WARNING,并返回 &null;。
8.0.0
如果 array 为空,array_rand
现在会抛出一个 ValueError;
之前会抛出一个 E_WARNING,并返回 &null;。
7.1.0
内部随机化算法已从 libc rand 函数更改为使用
梅森旋转算法(Mersenne Twister) 随机数生成器。
&reftitle.examples;
array_rand 例子
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeys
Random\Randomizer::shuffleArray