count (Anzahl von Listeneinträgen)
Die Funktion $count zählt die Anzahl von gegebenen Werten. Dabei werden sowohl die einzelnen Parameter als auch Parameter die selbst eine Liste sind mit in das Ergebnis einbezogen.
Syntax
$count(a[,b[,c[,...]]])
Parameter
$count() akzeptiert eine beliebige Anzahl an Parametern für die jeweils folgendes gilt:
ist ein Parameter keine Liste, so wird er zum Ergebnis hinzu gezählt, unabhängig davon, ob er leer, undefiniert oder null ist
ist ein Parameter eine Liste, so wird jeder Eintrag der Liste zum Ergebnis hinzu gezählt, ebenfalls unabhängig davon ob er leer, undefiniert oder null ist
Tipp
Um undefinierte oder leere Werte vom Ergebnis auszuschließen, kann die Funktion notEmptyFilter (nicht leere Werte auflisten) verwendet werden (analog numFilter (Zahlenfilter) für numerische Werte).
Beispiel: $count(a,$null,,d) liefert 4 wohingegen $count($notEmptyFilter(a,$null,,d) 2 liefert.
Rückgabewert
Die Anzahl von angegebenen Werten. Ist ein Wert selbst eine Liste, so wird die Anzahl seiner Einträge ebenfalls zum Ergebnis hinzu gezählt.
Beispiele
|
Syntax |
Ergebnis |
Bemerkung |
|
$count(a,b,c) |
3 |
Jeder Parameter wird gezählt |
|
$count(a,b,c,$null) |
4 |
null und leere Werte werden trotzdem gezählt |
|
$count($numfilter(a,2,3,$null,abc),b,c) |
4 |
$numfilter liefert die Liste [2,3] und daher ergibt das Ergebnis zusammen mit den Parametern b und c eine Gesamtzahl von 4 |
|
$count($notEmptyFilter(a,2,3,$null,abc),b,c) |
6 |
$notEmptyFilter liefert die Liste [a,2,3,abc] und daher ist das Ergebnis zusammen mit den Parametern b und c gleich 6 |
|
$count($el(28,true)) |
Anzahl an Duplikaten des Elements 28 |
Nur in Formularen anwendbar |
Siehe auch