array_all

(PHP 8 >= 8.4.0)

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

説明

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

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

パラメータ

array

検索する array。

callback

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

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

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

戻り値

callback がすべての要素に対して true を返す場合、この関数は true を返します。そうでない場合 false を返します。

例

例1 array_all() の例

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

// すべての動物名が12文字未満かどうかをチェックします。
var_dump(array_all($array, function (string $value) {
    return strlen($value) < 12;
}));

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

// すべての配列キーが文字列かどうかをチェックします。
var_dump(array_all($array, function (string $value, $key) {
   return is_string($key);
}));
?>

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

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

参考

array_any() - 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 3 notes

down

Anonymous ¶

7 months ago

if (! function_exists('array_all')) {
    function array_all(array $array, callable $callable) {
        foreach ($array as $key => $value) {
            if (! $callable($value, $key))
                return false;
        }
        return true;
    }
}

down

Anonymous ¶

28 days ago

<?php

function array_all(array $array, callable $callback): bool
{
    return array_reduce($array, fn($r, $e) => $r && $callback($e), true);
}

?>

down

bartosz dot f at example dot com ¶

3 months ago

The function will always return true for empty array.

php > var_dump(array_all([], fn()=> true));
bool(true)
php > var_dump(array_all([], fn()=> false));
bool(true)

＋add a note