count

(PHP 4, PHP 5, PHP 7)

count — Подсчитывает количество элементов массива или чего-либо в объекте

Описание

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

Подсчитывает количество элементов массива или чего-то в объекте.

Для объектов, если у вас включена поддержка SPL, вы можете перехватить count(), реализуя интерфейс Countable. Этот интерфейс имеет ровно один метод, 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.

Примеры

Пример #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));

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 // Начиная с PHP 7.2
int(0)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14 // Начиная с PHP 7.2
int(1)

Пример #2 Пример рекурсивного использования count()

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

// рекурсивный подсчет
echo count($food, COUNT_RECURSIVE); // выводит 8

// обычный подсчет
echo count($food); // выводит 2

?>

Список изменений

Версия Описание
7.2.0 count() теперь будет выдавать предупреждение о некорректных исчисляемых типов, переданных в параметр array_or_countable.

Смотрите также

  • is_array() - Определяет, является ли переменная массивом
  • isset() - Определяет, была ли установлена переменная значением, отличным от NULL
  • empty() - Проверяет, пуста ли переменная
  • strlen() - Возвращает длину строки
  • is_countable() - Проверить, что содержимое переменной является счетным значением