array_any

(PHP 8 >= 8.4.0)

array_any — array のいずれかの要素がコールバック関数を満たすかどうかを調べる

説明

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

array_any() は、指定されたcallback がいずれかの要素に対して true を返す場合 true を返します。そうでない場合 false を返します。

パラメータ

array

検索する array。

callback

各要素を調べるコールバック関数。シグネチャは次の通りです:

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

この関数が true を返すと、 array_any() から true が返され、以降の要素に対してはコールバックは呼び出されません。

戻り値

この関数は、callback が true を返す要素が少なくとも1つある場合、true を返します。そうでない場合 false を返します。

例

例1 array_any() の例

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

// いずれかの動物名が5文字より長いかどうかをチェックします。
var_dump(array_any($array, function (string $value) {
    return strlen($value) > 5;
}));

// いずれかの動物名が3文字より短いかどうかをチェックします。
var_dump(array_any($array, function (string $value) {
    return strlen($value) < 3;
}));

// 配列キーに文字列でないものがあるかどうかをチェックします。
var_dump(array_any($array, function (string $value, $key) {
   return !is_string($key);
}));
?>

上の例の出力は以下となります。

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

参考

array_all() - array のすべての要素がコールバック関数を満たすかどうかを調べる
array_filter() - コールバック関数を使用して、配列の要素をフィルタリングする
array_find() - コールバック関数を満たす最初の要素を返す
array_find_key() - コールバック関数を満たす最初の要素のキーを返す

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

miken32 at example dot com ¶

3 hours ago

This can be a replacement for array_filter() where an existence check is the only purpose. But, unlike array_filter(), the callback always requires two arguments. There's no way to change this, so some a lot of old-fashioned string callables are no longer usable.

<?php
$arr = [45, 'abc', 'def', 'ghi'];

if (array_filter($arr, 'is_integer')) {
    // works because of loose comparison: [45] == true
}

if (array_any($arr, 'is_integer')) {
    // PHP Warning:  Uncaught ArgumentCountError: is_integer() expects exactly 1 argument, 2 given
}
?>

＋add a note