EndOfList

Top Previous Next

S	A	W	WS
ü	ü

Syntax -

If EndOfList <LISTNAME> …

Where:

<LISTNAME> is a literal string or a variable containing a literal string.

Description:

This comparison operator returns a TRUE condition if the current item pointer has moved past the end of the specified list. This is very similar in function to the If EOF test which is used for files instead of lists. The use of this comparison can replace the use of a counter to track the number of members in a list or prevent the need to store a dummy value in a list. If EndOfList will return a TRUE condition if the list is empty.

This comparison should be performed before the use of a GetListMember command to insure that the current list item pointer is pointing to a valid list item. The list pointer can be moved beyond the end of a list by the following actions.

•	The GetListMember command, which advances the pointer by 1.

•	The SetListPosition command, which can advance to list pointer beyond the end of the list.

•	The FindListPosition command, which will advance the list pointer beyond the end of the list when there is not a match to the requested criteria.

This comparison operator can be used with either an in-line If (the original OLIE™ syntax) or a Block If.