Funkcja array_rand

Funkcja array_rand zwraca losowy klucz z tablicy. Pierwszym parametrem jest tablica, a drugi opcjonalny parametr określa, ile losowych kluczy należy zwrócić. Jeśli nie jest podany - zwracany jest jeden klucz, a jeśli podany - określona liczba kluczy w postaci tablicy.

Składnia

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

Przykład

W tym przykładzie funkcja zwróci losowy klucz z tablicy:

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

Wynik wykonania kodu:

php'c'

Przykład

Zwróćmy losowy element z tablicy, znając losowy klucz:

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

Wynik wykonania kodu:

php3

Przykład

Ustawmy drugi parametr na wartość 3 - w tym przypadku funkcja zwróci tablicę 3 losowych kluczy (3 klucze - ponieważ drugi parametr wynosi 3):

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

Wynik wykonania kodu:

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

Zobacz też

  • funkcję shuffle,
    która tasuje tablicę
  • funkcję mt_rand,
    która zwraca losową liczbę