MiniRobotLanguage (MRL)
PSS. Command
PUsh String Variable(s) on the user stack
Intention
Takes up to 25 String/Text-Variables, which content is been pushed on Top of the User-Stack/the Queue. Counterpart to POV. (POP Variables from Stack).
You can Push any variables onto the stack. PSS. will do a String-type variable resolution.
While PVS. and PUS. explicitly does NOT resolve variables and special-folder, POP. PUV. PSS., PNS do just that.
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.
Sample-Code and a Stack-Printout:
$$LAA="Hallo you "
$$LAB=(1+2+3*45)
PSS.People|$$LAA|$$LAB
DMP.6
POV.$$TXA|$$TXB|$$TXC
DMP.6
PRT.$$TXA#$$TXB##$$TXC
MBX.!
Please compare the results with those from the PNS. - Command.
$$LAA="Hallo you "
$$LAB=(1+2+3*45)
PNS.People|$$LAA|$$LAB
DMP.6
POV.$$TXA|$$TXB|$$TXC
DMP.6
PRT.$$TXA#$$TXB##$$TXC
MBX.!
Syntax
PSS.P1[|P2]...[|P25]
Parameter Explanation
P1 - Variables with Text or String COntent. Should not be binary content that may eventually get Variable-Expanded.
P2 - Px - (optional) More Variables
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 deleted from stack or not also 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
PSS.$$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
• POP. - POP Variable from Stack
• POV. - POp Variables from User-Stack