CountSubset (Arraylist function)

Number of items matching a criterion (Arraylist class)

[Introduced in Sirius Mods 7.8]

Syntax

%count = al:CountSubset( selectionCriterion)

Syntax terms

%count	A numeric variable to contain the count of matching items.
al	An Arraylist object.
selectionCriterion	A SelectionCriterion object, which is a relational expression that is applied to an al item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value. For example, GT(this, -11) is the criterion this > -11, where this is an identity function value that simply returns the item's value. The items that satisfy this expression populate the subset whose count CountSubset returns. The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the al Arraylist declaration and that returns a numeric or string value. This is described further in "Specifying a SelectionCriterion's parameters".

Usage notes

• A CountSubset call with a particular selection criterion is equivalent to a count of the items in the subset returned by the SubsetNew method with that criterion.

Examples

The following request shows a CountSubset call with a simple selection criterion:

begin %al is arraylist of float %al = list(111, 29, 0, 93, 77, -345) %sel is object selectioncriterion for float %sel = GT(this, 0) printText {~} = {%al:countSubset(%sel)} end

The result is:

%al:countSubset(%sel) = 4

See also

Arraylist class FloatNamedArraylist class NamedArraylist class UnicodeNamedArraylist class	List of Arraylist methods List of FloatNamedArraylist methods List of NamedArraylist methods List of UnicodeNamedArraylist methods List of Collection methods	Arraylist methods syntax FloatNamedArraylist methods syntax NamedArraylist methods syntax UnicodeNamedArraylist methods syntax
Notation conventions for methods