List Built-in Methods

The methods provide list management and dynamic attribute specification capabilities.

The list attributes provide list behavior, to create lists that can be used to populate content controls such as list boxes, combo boxes, and data grids in a client form or an application. The list can be instantiated and used in logic to hold list items. A list can contain items defined by user-defined classes. Following are the built-in methods that can be referred through a list attribute.

Add

The Add built-in method adds an item to a list attribute.

Syntax

<<listAttribute>>::Add(<T value>) : void 

Owner

List Attribute

Parameters

T value

A user-defined object type that contains the structure of the items to be stored in a list. The object type should be of the type you specified in the Template property of the list object.

Clear

The Clear built-in variable method clears the entire contents of the scalar or array variable in a single operation. If it is a string-primitive variable, it (or each element in the array) is set to spaces. If it is a number-primitive variable, it (or each element in the array) is set to zero.

Syntax

<<variable>>::Clear(void) : void

Owner

Any variable.

Example

MyVariable := "Contents"      : MyVariable has the value "Contents"
MyVariable.Clear()            : MyVariable is now "        "

Count

The Count built-in Data Set method returns the number of members of the set.

Syntax

<<datasetInstance>>::Count(void) : numericLiteral

Owner

Any data set.

Return type

A numeric literal.

IsEmpty

The IsEmpty built-in Data Set method returns true if the set is empty (it has no members).

Syntax

<<datasetInstance>>::IsEmpty(void) : Boolean

Owner

Any data set.

Return type

A boolean.