array_randWybiera jeden lub więcej losowych elementów z tablicy
&reftitle.description;
intstringarrayarray_randarrayarrayintnum1
Wybiera jeden lub więcej losowych elementów z tablicy i zwraca
klucz (lub klucze) tych losowych elementów.
&caution.cryptographically-insecure;
&reftitle.parameters;
array
Tablica wejściowa.
Nie może być pusta.
num
Określa jak wiele elementów powinno być wybranych.
Musi być większe od zera i mniejsze lub równe liczbie elementów w tablicy array
&reftitle.returnvalues;
Jeśli wyciągasz tylko jeden element, array_rand
zwraca klucz losowego wpisu. W przeciwnym przypadku zwracana jest tablica
zawierająca klucze losowych wpisów. Dzieje się tak, żeby można było
wyciągnąć jednocześnie klucze i wartości losowych elementów tablicy.
Jeśli zwracane jest wiele kluczy, to są one zwrócone w kolejności,
w której występowały w oryginalnej tablicy.
&reftitle.errors;
Rzuca błąd ValueError jeśli tablica array jest pusta
lub jeśli num jest poza dozwolonym zakresem.
&reftitle.changelog;
&Version;&Description;8.0.0array_rand rzuca teraz błąd ValueError,
jeśli num jest poza dozwolonym zakresem; wcześniej generowane było ostrzeżenie
E_WARNING a funkcja zwracała &null;.
8.0.0array_rand rzuca teraz błąd ValueError,
jeśli tablica array jest pusta; wcześniej generowane było ostrzeżenie
E_WARNING a funkcja zwracała &null;.
7.1.0
Wewnętrzny algorytm losowości został zmieniony na Mersenne Twister Random Number Generator zamiast funkcji rand z libc.
&reftitle.examples;
Przykład użycia <function>array_rand</function>
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeysRandom\Randomizer::shuffleArray