count

関数の概要

PHPの count 関数は、配列やオブジェクトの要素数を取得するために使われます。特に配列操作の際に、何個の要素が含まれているかを調べたい場合に便利です。配列の要素数を正確に取得することで、ループ処理や条件分岐などに役立てられます。

パラメータの説明

  • array_or_countable (必須)：要素数を調べたい配列または Countable インターフェースを実装したオブジェクトを指定します。
  • mode (省略可能)：整数値。COUNT_NORMAL（デフォルト）または COUNT_RECURSIVE（再帰的にカウント）を指定できます。多次元配列の全ての要素数を含めたい場合に COUNT_RECURSIVE を使います。

戻り値

配列やオブジェクト内の要素数を整数で返します。もし引数が配列でもオブジェクトでもない場合は、0を返します。

使用例

基本的な使い方

<?php
$array = [1, 2, 3, 4, 5];
echo count($array); // 5
?>

単純な配列の要素数を取得しています。ここでは配列に5個の要素があるため、5が出力されます。

多次元配列の要素数を数える

<?php
$array = [
    'fruits' => ['apple', 'banana', 'orange'],
    'vegetables' => ['carrot', 'onion']
];
echo count($array); // 2
echo count($array, COUNT_RECURSIVE); // 7
?>

この例では、通常のカウントだと1次元目の要素数（キーの数）が取得でき、再帰的カウントでは全階層の要素数合計を取得できます。

空配列の要素数

<?php
$emptyArray = [];
echo count($emptyArray); // 0
?>

空の配列に対しては0が返ります。データの有無を確認するのに有効です。

関連する関数

  • sizeof： count のエイリアスで機能は同じです。
  • array_key_exists：配列のキーの存在を調べる関数。
  • empty：変数が空かどうか判定する関数。

まとめ

count 関数はPHPで配列の要素数を取得する際に欠かせない基本的かつ便利な関数です。要素数に応じた処理や配列の状態確認に利用できます。多次元配列の全要素数を調べたい場合は、第2引数に COUNT_RECURSIVE を指定することで再帰的にカウント可能です。初心者から実務まで幅広く使われる関数なので、使い方をしっかり理解しておくことをおすすめします。

スポンサーリンク