array_any

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

説明

mixed array_any(array $array, callable $callback)

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

パラメータ

array

検索する array。

callback

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

bool callback(mixed $value, mixed $key)

この関数が 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_filter
array_find
array_find_key