==== ROLLD ====
----
----
Move object at level 1 to level N
----
^ __Input Stack__ ^^^^^ ^ __Output Stack__ ^^^^^
| **On** | **...** | **O2** | **O1** | **In** | **→** | **O1** | **On** | **...** | **O3** | **O2** |
| //Level n+1// | //...// | //Level 3// | //Level 2// | //Level 1// | //→// | //Level n// | //Level n-1// | //...// | //Level 2// | //Level 1// |
{{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}
|**Type**| [[manual:chapter5:basics#commands|Command]] ||
|**Parallel list processing**| [[manual:chapter5:listproc#group-2commands-that-must-use-dolist-to-parallel-process|Group 2]] ||
|**Affected by flags**| None ||
----
The ''ROLLD'' command moves the object on the second level of the stack to the specified level of the stack (i.e. the (N+1)-th level, since level 1 contains N), dropping the other objects accordingly.
----
This command is fully compatible with userRPL.
----
6: ∡60°
5: 123
4: "This is a string"
3: { 'X' 'Y' 'Z' }
2: 1_m
1: 4
……………………………………………………………………………………
ROLLD
will result in
5: ∡60°
4: 1_m
3: 123
2: "This is a string"
1: { 'X' 'Y' 'Z' }
……………………………………………………………………………………
----
{{page>manual:chapter6:stack&nofooter&noeditbtn&inline}}