【PHP8.x】array_all関数の使い方

Copy
1<?php
2
3/**
4 * 指定された配列の全ての要素が、指定されたコールバック関数によるテストに合格するかどうかをチェックします。
5 *
6 * @param array    $array    チェックする配列
7 * @param callable $callback 各要素に対して実行するコールバック関数。引数として要素の値を受け取り、bool値を返す必要があります。
8 *
9 * @return bool 配列の全ての要素がコールバック関数によるテストに合格した場合はtrue、そうでない場合はfalse。
10 */
11function array_all(array $array, callable $callback): bool
12{
13    foreach ($array as $value) {
14        if (!$callback($value)) {
15            return false; // いずれかの要素がテストに失敗した場合、falseを返す
16        }
17    }
18
19    return true; // 全ての要素がテストに合格した場合、trueを返す
20}
21
22// サンプル使用例
23$numbers = [2, 4, 6, 8, 10];
24
25// 全ての要素が偶数かどうかをチェックするコールバック関数
26$isEven = function (int $number): bool {
27    return $number % 2 === 0;
28};
29
30// array_all関数を使用して、配列の全ての要素が偶数かどうかをチェック
31$allEven = array_all($numbers, $isEven);
32
33// 結果を出力
34var_dump($allEven); // bool(true)

array_all関数は、PHP 8で配列のすべての要素が、指定されたコールバック関数によるテストに合格するかどうかを判定する関数です。システムエンジニアを目指す初心者の方にも理解しやすいように、具体的な例を交えながら説明します。

この関数は、第一引数に検査対象の配列 $array を、第二引数に各要素に対して実行するコールバック関数 $callback を受け取ります。コールバック関数は、配列の各要素の値を引数として受け取り、その要素がテストに合格したかどうかを示す真偽値（bool）を返す必要があります。

array_all関数は、配列内のすべての要素に対してコールバック関数を実行し、いずれかの要素がコールバック関数でfalseを返した場合、直ちにfalseを返します。つまり、配列の中に条件を満たさない要素が一つでも存在すれば、全体のテストは失敗となります。

一方、配列内のすべての要素がコールバック関数でtrueを返した場合、array_all関数はtrueを返します。これは、配列のすべての要素が指定された条件を満たしていることを意味します。

サンプルコードでは、$numbersという配列のすべての要素が偶数であるかどうかをチェックしています。$isEvenというコールバック関数は、与えられた数値が偶数であればtrueを、奇数であればfalseを返します。array_all($numbers, $isEven)を実行することで、$numbers配列のすべての要素が偶数であるかどうかが判定され、結果がvar_dumpによって出力されます。この例では、すべての要素が偶数であるため、bool(true)が出力されます。

Copy
1<?php
2
3/**
4 * array_fill_keys() 関数の使用例を示します。
5 * 指定されたキー配列の各要素を新しい配列のキーとして使用し、
6 * すべてのキーに同じ値を割り当てて配列を生成します。
7 */
8function demonstrateArrayFillKeys(): void
9{
10    // 新しい配列のキーとして使用する値の配列を定義します。
11    $keys = ['apple', 'banana', 'orange'];
12
13    // すべてのキーに割り当てる値を定義します。
14    $fillValue = 'fruit';
15
16    // array_fill_keys() を使用して配列を生成します。
17    // 'apple' => 'fruit', 'banana' => 'fruit', 'orange' => 'fruit' のような配列ができます。
18    $newArray = array_fill_keys($keys, $fillValue);
19
20    echo "元のキー配列:\n";
21    print_r($keys);
22    echo "\n";
23
24    echo "割り当てる値: " . $fillValue . "\n";
25    echo "\n";
26
27    echo "array_fill_keys() で生成された配列:\n";
28    print_r($newArray);
29}
30
31// 関数を実行して結果を表示します。
32demonstrateArrayFillKeys();
33
34?>

array_fill_keys()関数は、指定されたキーの配列と一つの値を使って、新しい連想配列を効率的に生成するためのPHPの標準関数です。

この関数は二つの引数を取ります。第一引数array $keysには、新しい配列のキーとして使用したい要素を含む配列を指定します。例えば、['apple', 'banana']のような文字列の配列や、数値の配列などを渡すことができます。第二引数mixed $valueには、$keys配列で指定されたすべてのキーに共通して割り当てる値を指定します。この値は文字列、数値、真偽値など、あらゆる型のデータを設定できます。

array_fill_keys()は、$keys配列の各要素を新しい配列のキーとして使用し、それらのキーすべてに$value引数で指定した値を割り当てた新しい連想配列を戻り値として返します。例えば、キーとして['apple', 'banana']、値として'fruit'を指定した場合、['apple' => 'fruit', 'banana' => 'fruit']のような配列が生成されます。

サンプルコードでは、['apple', 'banana', 'orange']というキー配列と、'fruit'という割り当てる値をarray_fill_keys()関数に渡しています。これにより、各フルーツの名前がキーとなり、そのすべてに'fruit'という値が設定された新しい配列が作成され、その内容が表示されることを確認できます。この関数は、複数のキーに同じデフォルト値を設定したい場合に特に役立ちます。