(PHP 4, PHP 5, PHP 7, PHP 8)
count — Подсчитывает количество элементов в массиве или в объекте Countable
Функция подсчитывает количество элементов в массиве, если в функцию передали массив. Функция возвращает значение, которое вернул метод Countable::count() , если в функцию передали объект, который реализует интерфейс Countable .
valueМассив или объект, который реализует интерфейс Countable .
mode
Функция count() будет рекурсивно подсчитывать элементы массива,
если для необязательного параметра mode установили значение
COUNT_RECURSIVE (или 1).
Это, в частности, полезно для подсчёта элементов многомерных массивов.
Функция count() умеет обнаруживать рекурсию, чтобы избежать
бесконечного цикла, но для каждого такого случая будет выдавать ошибку уровня
E_WARNING (если массив содержит себя
больше одного раза), и возвращать значение выше, чем ожидалось.
Функция возвращает количество элементов в параметре value.
До PHP 8.0.0, если параметр не был ни массивом (array ),
ни объектом (object ), который реализует интерфейс Countable ,
возвращалось значение 1,
если значение параметра value не было равно null ,
тогда возвращалось значение 0.
| Версия | Описание |
|---|---|
| 8.0.0 |
Теперь функция count() выбрасывает
исключение TypeError , если в параметр
value передали недопустимый исчисляемый тип.
|
| 7.2.0 |
Теперь функция count() будет выдавать предупреждение
о недопустимых исчисляемых типах, которые передали в параметр value.
|
Пример #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));
?>Результат выполнения приведённого примера:
int(3) int(3)
Пример #2 Пример вызова функции count() на значении с неисчисляемым типом, которое не принадлежит объединению типов Countable|array (плохой пример — не делайте так)
<?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'));
// рекурсивный подсчёт
var_dump(count($food, COUNT_RECURSIVE));
// обычный подсчёт
var_dump(count($food));
?>Результат выполнения приведённого примера:
int(8) int(2)
Пример #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));
?>Результат выполнения приведённого примера:
int(2)
[Editor's note: array at from dot pl had pointed out that count() is a cheap operation; however, there's still the function call overhead.]
If you want to run through large arrays don't use count() function in the loops , its a over head in performance, copy the count() value into a variable and use that value in loops for a better performance.
Eg:
// Bad approach
for($i=0;$i<count($some_arr);$i++)
{
// calculations
}
// Good approach
$arr_length = count($some_arr);
for($i=0;$i<$arr_length;$i++)
{
// calculations
}If you are on PHP 7.2+, you need to be aware of "Changelog" and use something like this:
<?php
$countFruits = is_array($countFruits) || $countFruits instanceof Countable ? count($countFruits) : 0;
?>
You can organize your code to ensure that the variable is an array, or you can extend the Countable so that you don't have to do this check.I actually find the following function more useful when it comes to multidimension arrays when you do not want all levels of the array tree.
// $limit is set to the number of recursions
<?php
function count_recursive ($array, $limit) {
$count = 0;
foreach ($array as $id => $_array) {
if (is_array ($_array) && $limit > 0) {
$count += count_recursive ($_array, $limit - 1);
} else {
$count += 1;
}
}
return $count;
}
?>My function returns the number of elements in array for multidimensional arrays subject to depth of array. (Almost COUNT_RECURSIVE, but you can point on which depth you want to plunge).
<?php
function getArrCount ($arr, $depth=1) {
if (!is_array($arr) || !$depth) return 0;
$res=count($arr);
foreach ($arr as $in_ar)
$res+=getArrCount($in_ar, $depth-1);
return $res;
}
?>A function of one line to find the number of elements that are not arrays, recursively :
function count_elt($array, &$count=0){
foreach($array as $v) if(is_array($v)) count_elt($v,$count); else ++$count;
return $count;
}For a Non Countable Objects
$count = count($data);
print "Count: $count\n";
Warning: count(): Parameter must be an array or an object that implements Countable in example.php on line 159
#Quick fix is to just cast the non-countable object as an array..
$count = count((array) $data);
print "Count: $count\n";
Count: 250