manual:chapter6:stack:cmd_drop [newRPL User Manual]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
==== DROP ====
----
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Remove one object from the top of the stack
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^  ^  __Output Stack__  ^
|  **O**  |  **→**  |  |
|  //Level 1//  |  //→//  |  //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**|  [[manual:appendix:flags#flag-28|-28]] | RPL / RPN stack mode  |
|:::|  [[manual:appendix:flags#flag-29|-29]] | RPN stack depth  |
</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
The ''DROP'' command deletes the object on the top of the stack, shifting the remaining ones by one level.

When the stack is in RPN mode ''DROP'' fills immediately the bottom-most level of the stack (level 4 or level 8, depending on the selected stack depth) with the value it stored before the shift happened.
</callout>

<callout type="warning" icon="true" title="Compatibility">
----
This command is only partially compatible with userRPL.

In particular:
  * In userRPL RPN stack mode is not supported.
</callout>

<callout type="info" icon="true" title="Usage">
----
<code>
3:            "This is a string"
2:               { 'X' 'Y' 'Z' }
1:                           1_m
……………………………………………………………………………………
DROP
</code>
will result in
<code>
2:            "This is a string"
1:               { 'X' 'Y' 'Z' }
……………………………………………………………………………………

</code>
</callout>

<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
----
{{page>manual:chapter6:stack&nofooter&noeditbtn&inline}}
</callout>