List-Management

<< Click to Display Table of Contents >>

Navigation:  3. Script Language > Arrays and Data-Structures > LST. - List Arrays > List-Management >

List-Management

LST.Clear - Clear Data, keep List-Array Handle

Previous Top Next


MiniRobotLanguage (MRL)

 

LST.Clear

Clear Data, keep List-Array Handle

 

 

Intention

 

The LST.Clear command is used to delete all data stored in a specified list-array while keeping the list handle valid.

After executing this command, the List will be empty, but you can still use the list handle for further List-Operations.

 

 

 

Syntax

 

 

LST.Clr|P1

LST.Clear|P1

 

 

Parameter Explanation

 

P1 - (Variable) This Variable will contain the Handle for the List-Array.

 

 

Example

 

'***********************************

' LST.-Sample

'***********************************

LST.New|$$LST

DBP.New list created with this Handle: $$LST

DBP.List Clear Handle stays valid.

LST.Clr|$$LST

LST.Val|$$LST|$$RET

DBP.The Validity Check returns: $$RET

ENR.

 

 

 

Remarks

 

-

 

 

Limitations:

There are no limitations on the number of list arrays.

 

 

See also: