Funkce array_rand

Funkce array_rand vrací náhodný klíč z pole. Prvním parametrem je zadáno pole a druhý nepovinný parametr určuje, kolik náhodných klíčů by mělo být vráceno. Pokud není zadán - vrací se jeden klíč, a pokud je zadán - zadaný počet klíčů ve formě pole.

Syntaxe

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

Příklad

V tomto příkladu funkce vrátí náhodný klíč z pole:

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  echo array_rand($arr);
?>

Výsledek provedení kódu:

php'c'

Příklad

Vraťme náhodný prvek z pole, když známe náhodný klíč:

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  
  $key = array_rand($arr);
  echo $arr[$key];
?>

Výsledek provedení kódu:

php3

Příklad

Nastavme druhý parametr na hodnotu 3 - v tomto případě funkce vrátí pole 3 náhodných klíčů (3 klíče - protože druhý parametr je roven 3):

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  
  $keys = array_rand($arr, 3);
  var_dump($keys);
?>

Výsledek provedení kódu:

php['a', 'b', 'e']

Viz také

  • funkci shuffle,
    která zamíchá pole
  • funkci mt_rand,
    která vrací náhodné číslo