count
配列または Countable オブジェクトに含まれるすべての要素の数を数える
説明
int count(Countablearray $value, int $mode = COUNT_NORMAL)
パラメータ
-
value
-
配列あるいは Countable
オブジェクト。
-
mode
-
オプションのmode 引数が COUNT_RECURSIVE
(または 1) にセットされた場合、count
は再帰的に配列をカウントします。
これは多次元配列の全ての要素をカウントするといった場合に特に有効です。
警告
count は、再帰を検出して無限ループを回避するようになっています。
しかしその場合 (配列の中に自分自身が複数回登場する場合) は毎回 E_WARNING
を発行し、期待する結果より大きい数を返します。
戻り値
value の要素の数を返します。
PHP 8.0.0 より前のバージョンでは、
パラメータが配列でもなく
Countable インターフェイスを
実装したオブジェクトでもない場合、1 が返されていました。
ただし、value が null の場合、
0 が返されていました。
エラー / 例外
mode が COUNT_NORMAL でも
COUNT_RECURSIVE でもない場合、
ValueError がスローされます。
例
例1 count の例
<?php
$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));
?>
例2 Countable|array でない値を渡した場合の count の例 (悪い例です - 真似しないでね!)
<?php
$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
var_dump(count($b));
var_dump(count(null));
var_dump(count(false));
?>
int(3)
Fatal error: Uncaught TypeError: count(): Argument #1 ($var) must be of type Countable .. on line 12
例3 再帰的な count の例
<?php
$food = array('fruits' => array('orange', 'banana', 'apple'),
'veggie' => array('carrot', 'collard', 'pea'));
// recursive count
var_dump(count($food, COUNT_RECURSIVE));
// normal count
var_dump(count($food));
?>
例4 Countable オブジェクト
<?php
class CountOfMethods implements Countable
{
private function someMethod()
{
}
public function count(): int
{
return count(get_class_methods($this));
}
}
$obj = new CountOfMethods();
var_dump(count($obj));
?>
参考
- is_array
- isset
- empty
- strlen
- is_countable
- Arrays