SetListPosition

The following commands have been implemented in EMUEScript exactly as they are implemented in OLIE™:

Syntax -

SetListPosition <List Name> <Position> <Origin>

       Where:

               <List Name> is the user defined name that is assigned to the list.

               <Position> is a number or a variable containing a numeric value

               <Origin> is one of the following reserved values: Current, Set, End

Description:

This command is used to change the current position in the list.  The next execution of GetListMember will read at the new position <Position> relative to <Origin>.  If Current is used, the pointer is moved <Position> places relative to the current position.  That is, if <Position> is 2, then the pointer is moved to position beyond the current position.  The Set option indicates that the absolute position should be used.  In this case, if <Position> is 2, then the current position moves to the second item in the list regardless of where the current position had been before.  If End is specified, then the pointer is moved relative to the end of the list.

Sample 1:

       The following statement uses the SetListPosition command and the origin Current to move the get pointer forward in the list ListNumberOne by five records.

SetListPosition ListNumberOne 5 Current

Sample 2:

       The following statement uses the SetListPosition command and the origin Set to move the get pointer to the first member of the list named ListNumberOne.

SetListPosition ListNumberOne 1 Set

Sample 3:

       The following statement uses the SetListPosition command and the origin End to move the get pointer to the next to last member of the list named ListNumberOne.

SetListPosition ListNumberOne -1 End

See Also:

CreateList

DisposeList

ListExists

FindListPosition

GetListCount

GetListMember

GetListPosition

PutListMember