PHP Manual»Функції для роботи з масивами»array_any

array_any

(PHP 8 >= 8.4.0)

array_any — Checks if at least one array element satisfies a callback function

Опис

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

array_any() returns true, if the given callback returns true for any element. Otherwise the function returns false.

Параметри

array

The array that should be searched.

callback

The callback function to call to check each element, which must be of the following signature:

function callback(mixed $value, mixed $key): bool

If this function returns true, true is returned from array_any() and the callback will not be called for further elements.

Значення, що повертаються

The function returns true, if there is at least one element for which callback returns true. Otherwise the function returns false.

Приклади

Приклад #1 array_any() example

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

// Check, if any animal name is longer than 5 letters.
var_dump(array_any($array, function (string $value) {
    return strlen($value) > 5;
}));

// Check, if any animal name is shorter than 3 letters.
var_dump(array_any($array, function (string $value) {
    return strlen($value) < 3;
}));

// Check, if any array key is not a string.
var_dump(array_any($array, function (string $value, $key) {
   return !is_string($key);
}));
?>

Поданий вище приклад виведе:

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

Прогляньте також

array_all() - Checks if all array elements satisfy a callback function
array_filter() - Filters elements of an array using a callback function
array_find() - Returns the first element satisfying a callback function
array_find_key() - Returns the key of the first element satisfying a callback function