count

    (PHP 4, PHP 5, PHP 7, PHP 8)

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

    Описание

    function count(Countable|array $value, int $mode = COUNT_NORMAL): int

    Функция подсчитывает количество элементов в массиве, если в функцию передали массив. Функция возвращает значение, которое вернул метод 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)

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

    • is_array() - Определяет, представляет ли собой переменная массив
    • isset() - Определяет, объявили ли переменную и отличается ли её значение от null
    • empty() - Проверяет, пуста ли переменная
    • strlen() - Получает длину строки
    • is_countable() - Проверяет, счётно ли значение переменной
    • Массивы

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 6 notes

    up
    143
    onlyranga at gmail dot com
    12 years ago
    [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
}
    up
    3
    lucasfsmartins at gmail dot com
    7 years ago
    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.
    up
    13
    danny at dannymendel dot com
    19 years ago
    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;
}
?>
    up
    3
    pied-pierre
    11 years ago
    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;
}
    up
    10
    alexandr at vladykin dot pp dot ru
    19 years ago
    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;
  }
?>
    up
    0
    Anonymous
    6 years ago
    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
    ＋Добавить
    To Top