<< Click to Display Table of Contents >> Navigation:  3. Script Language > Arrays and Data-Structures > LST. - List Arrays > List-Management > List-Management

---

MiniRobotLanguage (MRL)

 

LST.New

Create a Handle for a new List-Array

 

 

Intention

 

This command gets a variable that holds a new list array.

 

LST.New|$$LST

 

This variable can then be used as a list array in other list array commands.

We recommend releasing the memory allocated for ListArrays at the end of the script.

While the robot will do this automatically, if the ListArray is no longer needed, you can easily free up the memory using the LST.End|$$LST command.  

 

The handle of a list array is just a long integer.

You can assign it to another variable and use that other variable as a handle for the list array too.

There's nothing special about the variable itself; it's simply the number it holds. 🔢✨

 

This number serves as the handle, or key, to the list array you've just created, enabling you to perform a variety of actions.

 

 

Syntax

 

 

LST.New|P1[|P2]

 

 

Parameter Explanation

 

P1 - (Variable) This Variable will return the Handle for the new created List-Array. Using this Handle you can access the List-Array with all commands.

P2 -  (optional) The element can be treated as:

  "f" - floating point number with a range of approximately +/- 3.4*10^-4932 to 1.2*10^4932, and offer 18 digits of precision

  "i" - 64-bit Integer number with a range of -9.22x10^18 to 9.22x10^18 ( -2^63 to 2^63 -1)

  "s" - String Data (default).

     If you do not specify P2, the item is treated as String (Text).

 

Example

 

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

' LST.-Sample

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

LST.New|$$LST

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

ENR.

 

 

 

 

Remarks

 

-

 

 

Limitations:

There are no limitations on the number of list arrays.

 

 

See also:

 

•