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

Copy
1<?php
2
3/**
4 * PHPのcount関数がnull値をどのように扱うかを示すサンプルコード。
5 *
6 * PHP 8.0以降のバージョンでは、count関数は通常、配列またはCountableインターフェースを
7 * 実装したオブジェクト以外の値に対してTypeErrorをスローします。
8 * しかし、null値については特別な挙動として、TypeErrorをスローせずに0を返します。
9 * この挙動はPHP 7.2以降で一貫しており、PHP 8.4でも同様です。
10 */
11
12// null値を変数に代入します。
13$nullValue = null;
14
15// count関数にnull値を渡した場合の結果を出力します。
16// 期待される結果は常に 0 です。
17echo "count(null) の結果: " . count($nullValue) . "\n";
18
19?>

PHPのcount関数は、配列やCountableインターフェースを実装したオブジェクトの要素数を数えるための関数です。引数$valueには数えたい対象を渡し、その要素数が整数型(int)として戻り値で返されます。$mode引数は省略可能で、通常は使用しません。

PHP 8.0以降のバージョンでは、count関数は原則として配列やCountableインターフェースを実装したオブジェクト以外の値が渡された場合、TypeErrorをスローします。しかし、null値については特別な挙動が定義されており、TypeErrorを発生させることなく常に0を返します。このnull値に対する挙動はPHP 7.2以降で一貫しており、PHP 8.4でも同様です。

サンプルコードは、このnull値に対するcount関数の特別な挙動を示すものです。変数にnullを代入し、それをcount関数に渡すことで、結果として0が出力されることを確認できます。これにより、null値が渡される可能性がある場合でも、別途エラーハンドリングを記述することなく安全に要素数を0として扱えるため、コードの記述を簡潔に保つことができます。

Copy
1<?php
2
3/**
4 * PHPのcount()関数の基本的な使用例を示します。
5 * この関数は、配列やCountableインターフェースを実装したオブジェクトの要素数を数えます。
6 * システムエンジニアを目指す初心者向けに、最も一般的な配列での使用例に焦点を当てています。
7 */
8function demonstrateCountFunction(): void
9{
10    // 1. 通常の数値インデックス配列の要素数を数える
11    $fruits = ["apple", "banana", "cherry"];
12    // count()関数は配列$fruitsの要素数を返します。
13    $numberOfFruits = count($fruits);
14    echo "フルーツの数: " . $numberOfFruits . "\n"; // 出力例: フルーツの数: 3
15
16    // 2. 連想配列の要素数を数える
17    $userProfile = [
18        "name" => "Alice",
19        "age" => 30,
20        "city" => "Tokyo"
21    ];
22    // 連想配列の場合も、キーと値のペアの数を数えます。
23    $numberOfProperties = count($userProfile);
24    echo "ユーザープロフィールのプロパティ数: " . $numberOfProperties . "\n"; // 出力例: ユーザープロフィールのプロパティ数: 3
25
26    // 3. 空の配列の要素数を数える
27    $emptyList = [];
28    // 空の配列の場合、count()関数は0を返します。
29    $numberOfEmptyItems = count($emptyList);
30    echo "空のリストの要素数: " . $numberOfEmptyItems . "\n"; // 出力例: 空のリストの要素数: 0
31
32    // 4. 多次元配列のトップレベル要素数を数える
33    // count()関数のデフォルト動作 (COUNT_NORMAL) では、ネストされた配列自体が1つの要素として数えられます。
34    $nestedData = [
35        "item_a",
36        ["sub_item_1", "sub_item_2"], // この配列全体が1つの要素として数えられる
37        "item_b"
38    ];
39    $numberOfTopLevelItems = count($nestedData);
40    echo "多次元配列のトップレベル要素数: " . $numberOfTopLevelItems . "\n"; // 出力例: 多次元配列のトップレベル要素数: 3
41}
42
43// 上記で定義した関数を実行し、結果を表示します。
44demonstrateCountFunction();
45

PHPのcount()関数は、配列やCountableインターフェースを実装したオブジェクトが持つ要素の数を数え、その合計を整数値として返すために利用されます。この関数は、第一引数に要素数を数えたい対象（配列やオブジェクト）を受け取ります。第二引数はオプションで数え方を指定できますが、通常は省略され、デフォルトのCOUNT_NORMAL（通常の数え方）が適用されます。

例えば、["apple", "banana", "cherry"]という3つの要素を持つ配列にcount()を使うと、3という結果が得られます。["name" => "Alice", "age" => 30, "city" => "Tokyo"]のような連想配列の場合でも、キーと値のペアの数を数えて3を返します。もし配列が[]のように空であれば、count()は0を返します。

多次元配列の場合、count()関数のデフォルト動作では、ネストされた配列自体が1つの要素として数えられます。例えば、["item_a", ["sub_item_1", "sub_item_2"], "item_b"]という配列では、["sub_item_1", "sub_item_2"]全体が1つの要素と見なされるため、トップレベルの要素数である3が返されます。このように、count()関数はPHPで配列やコレクションの要素数を手軽に確認するための、非常に重要で便利な関数です。