PHP Manual
Array Funktionen
Zählt alle Elemente eines Arrays oder eines Countable-Objekts

count

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

count — Zählt alle Elemente eines Arrays oder eines Countable-Objekts

Beschreibung

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

Zählt alle Elemente eines Arrays, wenn es mit einem Array verwendet wird. Bei Verwendung mit einem Objekt, das die Schnittstelle Countable nutzt, gibt es den Rückgabewert der Methode Countable::count() zurück.

Parameter-Liste

value: Ein Array oder ein Countable-Objekt.
mode: Wenn der optionale Parameter mode auf COUNT_RECURSIVE (oder 1) gesetzt ist, wird count() rekursiv durch das Array zählen. Dies kann besonders nützlich sein, um alle Elemente eines mehrdimensionalen Arrays zu zählen.

Achtung
count() kann Rekursion erkennen, um eine Endlosschleife zu vermeiden, erzeugt aber jedes Mal, wenn es das tut, ein E_WARNING (für den Fall, dass das Array sich selbst mehr als einmal enthält) und gibt eine höhere Anzahl zurück, als erwartet werden kann.

Rückgabewerte

Gibt die Anzahl von Elementen in value zurück. Vor PHP 8.0.0 wurde 1 zurückgegeben, wenn der Parameter weder ein Array noch ein Objekt mit implementierter Countable-Schnittstelle war, es sei denn, value war null, dann wurde 0 zurückgegeben.

Changelog

Version	Beschreibung
8.0.0	count() löst nun einen TypeError aus, wenn ungültige zählbare Typen an den Parameter `value` übergeben werden.
7.2.0	count() erzeugt nun eine Warnung für ungültige zählbare Typen, die an den Parameter `value` übergeben wurden.

Beispiele

Beispiel #1 count()-Beispiel


<?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));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

int(3)
int(3)

Beispiel #2 count()-Beispiel für ein nicht zählbares Array (schlechtes Beispiel - nicht verwenden)


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

var_dump(count(null));

var_dump(count(false));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

int(3)
int(0)
int(1)

Das oben gezeigte Beispiel erzeugt folgende Ausgabe mit PHP 7.2:

int(3)

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

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14
int(1)

Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:

int(3)

Fatal error: Uncaught TypeError: count(): Argument #1 ($var) must be of type Countable .. on line 12

Beispiel #3 Rekursives count()-Beispiel


<?php
$food = array('Obst' => array('Orange', 'Banane', 'Apfel'),
              'Gemüse' => array('Karotte', 'Kohl', 'Erbse'));

// rekursiv zählen
var_dump(count($food, COUNT_RECURSIVE));

// normales zählen
var_dump(count($food));

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

int(8)
int(2)

Beispiel #4 Countable-Objekt


<?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));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

int(2)

Siehe auch

is_array() - Prüft, ob die Variable ein Array ist
isset() - Prüft, ob eine Variable deklariert ist und sich von null unterscheidet
empty() - Prüft, ob eine Variable leer ist
strlen() - Ermitteln der String-Länge
is_countable() - Verify that the contents of a variable is a countable value
Arrays