PHP 8.3.27 Released!

    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

    up
    0
    miken32 at example dot com
    1 month 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
    To Top