array_any

(PHP 8 >= 8.4.0)

array_any — Prüft, ob mindestens ein Element eines Arrays eine Callback-Funktion erfüllt

Beschreibung

function array_any(array $array, callable $callback): bool

array_any() gibt true zurück, wenn die übergebene callback-Funktion für mindestens ein Element true zurückgibt. Andernfalls gibt die Funktion false 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 true von array_any() zurückgegeben und die Callback-Funktion wird für weitere Elemente nicht mehr aufgerufen.

Rückgabewerte

Die Funktion gibt true zurück, wenn es mindestens ein Element gibt, für das callback true zurückgibt. Andernfalls gibt die Funktion false zurück.

Beispiele

Beispiel #1 array_any()-Beispiel

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

// Prüft, ob irgendein Tiername länger als 5 Buchstaben ist.
var_dump(array_any($array, function (string $value) {
    return strlen($value) > 5;
}));

// Prüft, ob irgendein Tiername kürzer als 3 Buchstaben ist.
var_dump(array_any($array, function (string $value) {
    return strlen($value) < 3;
}));

// Prüft, ob irgendein Array-Schlüssel keine Zeichenkette ist.
var_dump(array_any($array, function (string $value, $key) {
   return !is_string($key);
}));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

bool(true)
bool(false)
bool(false)

Siehe auch

array_all() - Prüft, ob alle Elemente eines Arrays eine Callback-Funktion erfüllen
array_filter() - Filtert Elemente eines Arrays mittels einer Callback-Funktion
array_find() - Gibt das erste Element zurück, das eine Callback-Funktion erfüllt
array_find_key() - Gibt den Schlüssel des ersten Elements zurück, das eine Callback-Funktion erfüllt