array_push
array_reduce
Array Funktionen
PHP Manual

# array_rand

(PHP 4, PHP 5)

array_rand — Liefert einen oder mehrere zufällige Einträge eines Arrays

### Beschreibung

mixed array_rand ( array `$input` [, int `$num_req` = 1 ] )

Wählt einen oder mehrere Einträge aus einem Array aus und gibt den Schlüssel des zufälligen Eintrags bzw. die Schlüssel der zufälligen Einträge zurück.

### Parameter-Liste

`input`

  Das Eingabe-Array.

`num_req`

  Gibt an, wie viele Einträge Sie auswählen möchten. Falls mehr Einträge als im Array existieren angegeben werden, wird ein Fehler der Stufe `E_WARNING` erzeugt.

### Rückgabewerte

Wenn Sie nur einen Eintrag auswählen, liefert array_rand() den Schlüssel eines zufälligen Eintrages. Andernfalls wird ein Array mit den Schlüsseln der zufälligen Einträge zurückgegeben. Dies hat den Zweck, dass Sie zufällige Schlüssel und auch Werte aus dem Array auswählen können.

### Changelog

Version | Beschreibung
--- | ---
5.2.10 | Das Ergebnisarray wird nicht mehr gemischt.
4.2.0 | Der Zufallszahlengenerator wird automatisch initialisiert.

### Beispiele

Beispiel #1 array_rand()-Beispiel

`<?php
$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($input, 2);
echo $input[$rand_keys[0]] . "\n";
echo $input[$rand_keys[1]] . "\n";
?>`

### Siehe auch

- shuffle() - Mischt die Elemente eines Arrays

array_push
array_reduce
Array Funktionen
PHP Manual