(PHP 4, PHP 5, PHP 7, PHP 8)
count — Zählt alle Elemente eines Arrays oder eines Countable-Objekts
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.
valueEin 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.
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.
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.
| 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. |
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 mit PHP 7.2 folgende Ausgabe:
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)