array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.array-find.php', 1 => 'array_find', 2 => 'Gibt das erste Element zurück, das eine Callback-Funktion erfüllt', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.array-filter.php', 1 => 'array_filter', ), 'next' => array ( 0 => 'function.array-find-key.php', 1 => 'array_find_key', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/array-find.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_find

(PHP 8 >= 8.4.0)

array_find — Gibt das erste Element zurück, das eine Callback-Funktion erfüllt

Beschreibung

function array_find(array $array, callable $callback): mixed

array_find() gibt den Wert des ersten Elements eines Arrays zurück, für das die übergebene callback-Funktion true zurückgibt. Wenn kein passendes Element gefunden wird, gibt die Funktion null zurück.

Parameter-Liste

array
Das zu durchsuchende Array.
callback

Die Callback-Funktion, die zur Prüfung jedes Elements aufgerufen wird und die folgende Signatur haben muss:

function callback(mixed $value, mixed $key): bool
Wenn diese Funktion true zurückgibt, wird der Wert von array_find() zurückgegeben und die Callback-Funktion wird für weitere Elemente nicht mehr aufgerufen.

Rückgabewerte

Die Funktion gibt den Wert des ersten Elements zurück, für das callback true zurückgibt. Wenn kein passendes Element gefunden wird, gibt die Funktion null zurück.

Beispiele

Beispiel #1 array_find()-Beispiel

<?php
$array = [
'a' => 'dog',
'b' => 'cat',
'c' => 'cow',
'd' => 'duck',
'e' => 'goose',
'f' => 'elephant'
];

// Findet das erste Tier mit einem Namen, der länger als 4 Zeichen ist.
var_dump(array_find($array, function (string $value) {
return strlen($value) > 4;
}));

// Findet das erste Tier, dessen Name mit f beginnt.
var_dump(array_find($array, function (string $value) {
return str_starts_with($value, 'f');
}));

// Findet das erste Tier, bei dem der Array-Schlüssel das erste Zeichen des Tiernamens ist.
var_dump(array_find($array, function (string $value, $key) {
return $value[0] === $key;
}));

// Findet das erste Tier, bei dem der Array-Schlüssel einem regulären Ausdruck entspricht.
var_dump(array_find($array, function ($value, $key) {
return preg_match('/^([a-f])$/', $key);
}));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

string(5) "goose"
NULL
string(3) "cow"
string(3) "dog"

Siehe auch