Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

array_rand()

Sorteia chaves de um array não vazio.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

array_rand(array $array, int $num = 1): int|string|array

Sorteia chaves de um array não vazio. Uma escolha devolve uma chave e várias devolvem um array de chaves distintas na ordem original. As chaves permitem ler os valores. Uma quantidade fora do intervalo de 1 ao tamanho do array origina ValueError.

Assinatura

array_rand(array $array, int $num = 1): int|string|array

Saída do exemplo

[true,["a","b"]]

Exemplos

<?php
$bins = ['a'=>4,'b'=>7];
$one = array_rand($bins);
echo json_encode([array_key_exists($one, $bins), array_rand($bins, 2)]);

Resultado

[true,["a","b"]]

Fontes