WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

array_rand()

Wählt zufällige Schlüssel eines nichtleeren Arrays.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

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

Wählt zufällige Schlüssel eines nichtleeren Arrays. Bei einem Treffer kommt ein einzelner Schlüssel zurück, bei mehreren ein Array verschiedener Schlüssel in ursprünglicher Reihenfolge. Die Werte liest man mit diesen Schlüsseln. Eine Anzahl außerhalb von 1 bis zur Arraygröße löst ValueError aus.

Signatur

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

Ausgabe des Beispiels

[true,["a","b"]]

Beispiele

<?php
$bins = ['a'=>4,'b'=>7];
$one = array_rand($bins);
echo json_encode([array_key_exists($one, $bins), array_rand($bins, 2)]);

Ergebnis

[true,["a","b"]]

Quellen