count

(PHP 3, PHP 4 , PHP 5)

count -- 変数に含まれる要素の数を数える

説明

int count ( mixed var [, int mode])

varに含まれる要素の数を返します。 通常、varは配列です(他のものには、1つの要素しか ありませんから)。

変数が配列でない場合は1を返します。 (例外: count(NULL)0と等価)

注意: オプションのmode引数はPHP 4.2.0 以降で使用可能です。

オプションのmode引数がCOUNT_RECURSIVE (または1)にセットされた場合、count()は再帰的に 配列をカウントします。これは多次元配列の全ての要素をカウントするといった 場合に特に有効です。modeのデフォルトは 0です。

注意

count()は、セットされていない変数に関して0を返 しますが、変数が空の配列として初期化されている場合にも0を返します。 ある変数がセットされているかどうかを調べるには、 isset()を使用してください。

配列の実装やPHPでの使用法に関する詳細な説明についてはマニュアルの 配列のセクションを 参照下さい。

例 1. count() の例

<?php
$a
[0] = 1;
$a[1] = 3;
$a[2] = 5;
$result = count ($a);
// $result == 3

$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
$result = count ($b);
// $result == 3;
?>

例 2. recursive count()の例 (PHP >= 4.2.0)

<?php
$food
= array('fruits' => array('orange', 'banana', 'apple'),
              
'veggie' => array('carrot', 'collard', 'pea'));

// 再帰的なカウント
echo count($food, COUNT_RECURSIVE);  // output 8

// 通常のカウント
echo count($food);                  // output 2

?>

注意: sizeof()関数は、count() へのエイリアスです。

is_array(), isset(), strlen()も参照下さい。