array_randEscolhe uma ou mais chaves aleatórias de um array
&reftitle.description;
intstringarrayarray_randarrayarrayintnum1
Escolhe aleatóriamente um ou mais itens de um array, e retorna a
chave (ou chaves) do itens selecionados.
&caution.cryptographically-insecure;
&reftitle.parameters;
array
O array de entrada.
Não pode ser vazio.
num
Especifica quantos elementos deseja obter.
Deve ser maior que zero, e menor ou igual ao comprimento do array.
&reftitle.returnvalues;
Se estiver selecionando apenas um elemento, array_rand retorna
a chave para este elemento aleatório. De outra forma, ele retorna um array com as chaves desses
elementos selecionados. Assim é possível selecionar os elementos pelas chaves
no array assim como valores aleatórios. Se múltiplas chaves forem retornadas,
elas serão retornadas na ordem em que estavam presentes no array original.
&reftitle.errors;
Lança uma exceção ValueError se array estiver vazio,
ou se num estiver fora do intervalo permitido.
&reftitle.changelog;
&Version;&Description;8.0.0array_rand agora lança uma exceção ValueError
se num estiver fora do intervalo; anteriormente um
E_WARNING era emitido, e a função retornava &null;.
8.0.0array_rand agora lança uma exceção ValueError
se array estiver vazio; anteriormente um
E_WARNING era emitido, e a função retornava &null;.
7.1.0
O algoritmo de embaralhamento interno foi alterado para usar o Gerador de Números Aleatórios Mersenne Twister em vez da função rand da libc.
&reftitle.examples;
Exemplo de array_rand
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeysRandom\Randomizer::shuffleArray