count (Number of list entries)

See also: numFilter (Number filter), notEmptyFilter (List non-empty values)

The function $count counts the number of given values. Both the individual parameters and parameters that are themselves a list are included in the result.

Syntax

$count(a[,b[,c[,...]]])

Parameter

$count() accepts any number of parameters to which the following applies:

  • If a parameter is not a list, it is added to the result, regardless of whether it is empty, undefined or null.

  • If a parameter is a list, then every entry in the list is added to the result, regardless of whether it is empty, undefined or null.

Hint: To exclude undefined or empty values from the result, the function notEmptyFilter (List non-empty values) can be used (analog numFilter (Number filter) for numeric values).

Example: $count(a,$null,,d) returns 4 whereas $count($notEmptyFilter(a,$null,,d) returns 2.

Return value

The number of specified values. If a value is itself a list, the number of its entries is also added to the result.

Example

Syntax

Result

Remarks

$count(a,b,c)

3

Each parameter is counted.

$count(a,b,c,$null)

4

Null and empty values are counted anyway.

$count($numfilter(a,2,3,$null,abc),b,c)

4

$numfilter returns the list [2,3] and therefore the result together with the parameters b and c gives a total number of 4.

$count($notEmptyFilter(a,2,3,$null,abc),b,c)

6

$notEmptyFilter returns the list [a,2,3,abc] and therefore the result together with the parameters b and c is 6.

$count($el(28,true))

Number of duplicates of the element 28

Only applicable in forms.