count

(PHP 3, PHP 4, PHP 5)

count -- Zählt die Elemente einer Variable

Beschreibung

int count ( mixed var [, int mode] )

Liefert die Anzahl von Elementen in var, welche typischerweise ein Array ist (da alles andere ein Element enthält).

Ist var kein Array oder Objekt mit Interface Countable, wird 1 zurückgegeben (Ausnahme: count(NULL) ist gleich 0).

Für Objekte, wenn die SPL installiert ist, gibt es die Möglichkeit das Interface Countable zu implementieren. Dieses Interface besitzt die Methode count(), die den Rückgabewert für den Aufruf von count() zurück liefert.

Anmerkung: Anmerkung: Der Parameter mode wurde mit PHP 4.2.0 hinzugefügt.

Wenn der optionale Paramter mode auf COUNT_RECURSIVE gesetzt ist, wird rekursive die Anzahl der Elemente ermittelt. Das ist nützlich um alle Elemente eines mehr-dimensionalen Arrays zu ermitteln.

Warnung

count() kann keine unendliche Rekursion erkennen.

Ist mode nicht spezifizier, wird COUNT_NORMAL angenommen.

Warnung

count() kann 0 zurückgeben wenn die Variable nicht gesetzt ist, aber sie könnte ebenfalls 0 zurückgeben, wenn eine Variable als leeres Array initialisiert wurde. Verwenden Sie isset() um zu testen, ob eine Variable gesetzt ist.

In der Sektion Arrays finden Sie eine detaillierte Erklärung, wie Arrays in PHP implementiert sind und wie sie benutzt werden.

Beispiel 1. count()

<?php
$a
[0] = 1;
$a[1] = 3;
$a[2] = 5;
$result = count ($a);
//$result == 3

$b[0] = 7;
$b[5] = 9;
$b[10] = 11;
$result = count ($b);
// $result == 3;
?>

Anmerkung: Die Funktion sizeof() ist ein Alias für count().

Siehe auch is_array(), isset() und strlen().