MiniRobotLanguage (MRL)
POV. Command
Pop Variables from user stack
Intention
Takes up to 25 variables, which Content is been taken from the Stack/the Que.
Counterpart to PUV. - Push Variables onto Stack. You can however pop any Stack Content into variables.
You can PUV. any Stack Content into the variable(s).
While PVS. and PUS. explicitly does NOT resolve variables and special-folder, POP. PUV. PSS., PNS do just that.
The POP.-Command will do a variable resolution and trim the result.
To avoid Variable Resolution and trimming, when taking things from the Stack, you can use POV. or this:
VAO.$$VAR=$$000
PVS. - Put Variable-Name on Stack without resolving anything
PSS. - Resolve Variables and Special-Folders before putting the Variable on Stack
PNS. - Do a numerical resolution and calculate Formulas in the Variable (if they are in ()). Then put the result on TOS.
PUV. - Do a Variable-Type dependent Variable resolution. Variables that are defined in some way have a Variable-Type (See GVT.-Command)
PUS. - Put Variable-Name on Stack without resolving anything. Unlike PVS., Variables will not be split if separated with |"|". Just the whole Parameter will be placed on TOS.
Using teh following Script will bring you this Stack and Output:
$$LAA="Hallo Ihr"
PVS.Hallo|$$LAA|$$LAA
DMP.6
POV.$$TXT|$$TXA|$$TXB
DMP.6
PRT.$$TXT#$$TXA##$$TXB
MBX.!
Syntax
POV.[P1][|P2...|P25]
Parameter Explanation
P1 - Variable
P2 - Variable P2 to Px, separated by comma or |
The Stack being used is the actual User-Stack.
It can be the Local User Stack or the Global User-Stack, which depends on Settings done with STS.-Command.
If the popped items are being deleted from stack, depends on the Settings done with STS.
Example
' Pop Variables Content from User-Stack
'DBM.2
DBP.Items on Stack: #tos#
: $$TXA=Laba
: $$TXB=Lax
DBP. Variables Content (1): $$TXA-$$TXB
PUV.$$TXA|$$TXB
DBP. Items on Stack: #tos#
DBP. Item on TOS: <$dtos$>
DMP.4
: $$TXA=
: $$TXB=
DBP. Variables have been cleared (2): $$TXA-$$TXB
DMP.4
POV.$$TXB|$$TXA
DBP. Variables Content after POV. (3): $$TXA-$$TXB
MBX.Ready
END.
Remarks
-
Limitations:
25 Variables is the maximum number of possible parameters.
See also:
• STV. - Stack To/from Variable
• PUS. - Push Parameter onto Stack/Que
• PUV. PUsh variables on the User-Stack
• POP. - POP Variable from Stack