$lenmulti¶
Usage: $lenmulti(name[,separator])
Category: multi-value
Description:
Returns the number of elements in the multi-value variable name
. A literal value
representing a multi-value can be substituted for name
, using the separator
(or a semicolon followed by a space “; ” if not passed) to coerce the value into a
proper multi-valued variable. If name
is missing $lenmulti
will return “0”. If
separator
is specified but left blank (e.g. $setmulti(A; B; C,)
) the function
will return “1”.
Example:
The following statements will return the values indicated:
$set(foo,)
$lenmulti(%foo%) ==> "0"
$set(foo,A; B; C)
$lenmulti(%foo%) ==> "1"
$setmulti(foo,A; B; C)
$lenmulti(%foo%) ==> "3"
$lenmulti(A; B; C) ==> "3"
$lenmulti(A:A; B:B; C:C,:) ==> "4"
$lenmulti(,) ==> "0"
$lenmulti(,:) ==> "0"
$lenmulti(A; B; C,) ==> "1"