|
<< Click to Display Table of Contents >> Navigation: 3. Script Language > Arrays and Data-Structures > ARS. - Array's > !ARS. - Store/Restore Operations > ARS. - Store/Restore Operations |
MiniRobotLanguage (MRL)
ARS.Restore
Restore the container from a string.
Intention
The ARS.Restore command restores the contents of a container (e.g., a stack, queue, or deque) from a string representation. This allows the container's data to be reconstructed from a string, which was previously stored using ARS.Store.
Illustration:
String → Container:
┌───────────────┐
│ String Data │ → Container
└───────────────┘
Syntax
ARS.Restore|$$ARR|$$STRING
Parameter Explanation
P1 - $$ARR The handle of the container to restore.
P2 - $$STR The string representation of the container data.
Example
'***********************************
' ARS.Restore - Sample Script
'***********************************
' Create a new container
ARS.New|$$CON
' Store the container to a string
ARS.Store|$$CON|$$STRING
' Restore the container from the string
ARS.Restore|$$CON|$$STRING
DBP.Container restored from string.
' End the script
ENR.
Remarks
-
Limitations:
- The string must be a valid representation of the container data.
See also: