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

There are no user contributed notes for this page.