Array Funktionen
PHP Manual

count

(PHP 4, PHP 5)

countZählt alle Elemente eines Arrays oder Attribute eines Objekts

Beschreibung

int count ( mixed $var [, int $mode ] )

Zählt alle Elemente eines Arrays oder Attribute eines Objekts.

Wenn Sie die SPL installiert haben, können Sie in Objekten eine count()-Funktion nutzen, indem Sie das Interface Countable implementieren. Das Interface hat exakt eine Methode, nämlich count(), die den Rückgabewert der Funktion count() zurückliefert.

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

Parameter-Liste

var

Das Array.

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. Der Standardwert für mode ist 0. count() erkennt keine endlose Rekursion.

Rückgabewerte

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

Ist var kein Array oder Objekt mit Interface Countable, wird 1 zurückgegeben. Es besteht eine Ausnahme, wenn var NULL ist, in diesem Fall wird 0 zurückgegeben.

Achtung

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

Changelog

Version Beschreibung
4.2.0 Der optionale Parameter mode wurde hinzugefügt.

Beispiele

Beispiel #1 count()-Beispiel

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

$result count(null);
// $result == 0

$result count(false);
// $result == 1
?>

Beispiel #2 Rekursives count()-Beispiel

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

// rekursiv zählen
echo count($foodCOUNT_RECURSIVE); // gibt 8 aus

// normales zählen
echo count($food); // gibt 2 aus

?>

Siehe auch


Array Funktionen
PHP Manual