PHP - array_rand

Třída

Kořen \ Bez třídy

Metoda - array_rand

(PHP 4, PHP 5, PHP 7)

Vybere zadaný počet náhodných položek z předaného pole a vrátí pole obsahující klíče těchto položek.

Poznámka: Tato funkce používá generátor pseudonáhodných čísel a tak se nehodí na kryptografické účely.

Procedurální

• function array_rand (array $array, int $num = 1) : mixed

Parametry

Název	Datový typ	Výchozí hodnota	Popis
$array	array		Vstupní pole, ze kterého se náhodné klíče vyberou.
$num	int	1	Počet klíčů, který se má vybrat.

Návratové hodnoty

Vrací: mixed

Pokud parametr $num nabývá hodnoty 1 (a tedy je požadován jen jeden klíč), vrátí se jen tato hodnota.

Funkce vrátí pole, pokud parametr $num nabývá větší hodnoty než 1 (a tedy se požaduje více náhodných klíčů).

Pokus o výběr více klíčů, než v předaném poli je, vyústí ve vrácení hodnoty null a vygenerování E_WARNING.

Příklady

Tato ukázka vybere 2 náhodné klíče z pole, vypíše tyto vybrané klíče a s nimi spojené hodnoty:

<?php

$in = array('klic1' => 'Prvni polozka', 'klic2' => 'Druha polozka', 'klic3' => 'Treti polozka', 'klic4' => 'Ctvrta polozka');
$randKeys = array_rand($in, 2);

foreach($randKeys as $key){
    $value = $in[$key];
    echo "$key => $value" .  PHP_EOL;
}