PHP 8.1.31 Released!

array_any

(PHP 8 >= 8.4.0)

array_anyChecks if at least one array element satisfies a callback function

Description

array_any(array $array, callable $callback): mixed

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

Parameters

array
The array that should be searched.
callback

The callback function to call to check each element, which must be

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.

Return Values

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

Examples

Example #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);
}));
?>

The above example will output:

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

See Also

  • 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
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top