トップページ　→関数リファレンス　→変数・データ型関連　→配列　→配列関数

関数・クラス解説

count

version:PHP 4, PHP 5, PHP 7 (公式)

変数に含まれるすべての要素、あるいはオブジェクトに含まれる何かの数を数える

公式リファレンス

書式

count ( mixed $array_or_countable [, int $mode = COUNT_NORMAL ] ) : int

説明

変数に含まれるすべての要素、あるいはオブジェクトに含まれる何かの数を数えます。

オブジェクトに対して、もし SPL がインストールされている場合、インターフェイス Countable を実装することで count() にフックすることができます。このインターフェイスには 1 つのメソッド Countable::count() があり、count() 関数に対する値を返します。

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

パラメータ

array_or_countable: 配列あるいは Countable オブジェクト。
mode: オプションのmode 引数が COUNT_RECURSIVE (または 1) にセットされた場合、count() は再帰的に配列をカウントします。これは多次元配列の全ての要素をカウントするといった場合に特に有効です。
警告 count() は、再帰を検出して無限ループを回避するようになっています。しかしその場合 (配列の中に自分自身が複数回登場する場合) は毎回 E_WARNING を発行し、期待する結果より大きい数を返します。

返値

array_or_countable に含まれる要素の数を返します。もしパラメータが配列でもなく Countable インターフェイスを実装したオブジェクトでもない場合、1 が返されます。ひとつ例外があり、array_or_countable が NULL の場合、 0 が返されます。

更新履歴

バージョン	説明
7.2.0	count() 関数は、 array_or_countable パラメータに、不正な Countable 型を渡した場合に警告を発生させるようになりました。

サンプル

例1 count() の例 

$a[0] = 1;
$a[1] = 3;
$a[2] = 5;
var_dump(count($a));

$b[0]  = 7;
$b[5]  = 9;
$b[10] = 11;
var_dump(count($b));

var_dump(count(null));

var_dump(count(false));

 上の例の出力は以下となります。 
int(3)
int(3)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 12 // as of PHP 7.2
int(0)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14 // as of PHP 7.2
int(1)
 例2 再帰的な count() の例 

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

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

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

参考

is_array() - 変数が配列かどうかを検査する

isset() - 変数が宣言されていること、そして NULL とは異なることを検査する

empty() - 変数が空であるかどうかを検査する

strlen() - 文字列の長さを得る

is_countable() - 引数が、数えられる値かどうかを調べる

ワード検索

※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A	B	C	D	E	F	G	H	I	J
K	L	M	N	O	P	Q	R	S	T
U	V	W	X	Y	Z	_

最終更新一覧

●stristr
　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

●stripslashes
　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

●stripos
　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

●stripcslashes
　addcslashes() でクォートされた文字列をアンクォートする

●strip_tags
　文字列から HTML と PHP のタグを除去して返却

●strcspn
　指定した文字が最初に現れる位置を調べる

●strcoll
　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

●strcmp
　2つの文字列を比較し同じか（あるいは大小）を判定する

●strchr
　strstr() のエイリアス

●strcasecmp
　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

カテゴリー一覧

PHP の振る舞いの変更
 音声フォーマットの操作
 認証サービス
 コマンドライン関連
 圧縮およびアーカイブ
 暗号
 データベース関連
 日付および時刻関連
 ファイルシステム
 自然言語および文字エンコーディング
 画像処理および作成
 メール関連
 数学
 テキスト以外の MIME 型
 プロセス制御
 その他の基本モジュール
 その他のサービス
 検索エンジン用の拡張モジュール
 サーバー固有のモジュール
 セッション関連
 テキスト処理
 変数・データ型関連
 ウェブサービス
 Windows 用のモジュール
 XML 操作
 GUI用の拡張モジュール