<< Click to Display Table of Contents >> Navigation:  3. Script Language > Arrays and Data-Structures > ARS. - Array's > !ARS. - Array Operations > ARS. - Array Operations

---

MiniRobotLanguage (MRL)

 

ARS.Clear

Deletes all data in the container but keeps the handle valid.

 

 

Intention

 

The ARS.Clear command removes all elements from the array, effectively clearing it. The handle to the array remains valid and can be reused.

 

Illustration:

🗑️ Clearing array:
🔢 Before: [1, 3, 5, 7, 9]
🔢 After: []
🔑 Handle remains valid.

 

Syntax

 

ARS.Clear|$$ARR

 

 

Parameter Explanation

 

P1 - $$ARR - (Variable)

The handle of the array to be cleared.

 

Example

 

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

' ARS.Clear - Sample 1

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

ARS.New|$$ARR|s

ARS.Add|$$ARR|Hallo

ARS.Add|$$ARR|am

ARS.Add|$$ARR|Besten

ARS.Add|$$ARR|7.0

ARS.Clear|$$ARR

DBP.New Array cleared

'

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

' ARS.Clear - Sample 2

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

ARS.New|$$ARR|f

ARS.Add|$$ARR|2.5

ARS.Add|$$ARR|4.6

ARS.Add|$$ARR|6

ARS.Add|$$ARR|8

ARS.Clear|$$ARR

DBP.New Array cleared

'

 

 

Remarks

 

-

 

 

Limitations:

 

-

 

 

See also:

 

•