Differences

This shows you the differences between two versions of the page.

--- manual:chapter6:stack:cmd_drop [2018/03/14 15:40]
claudio
+++ manual:chapter6:stack:cmd_drop [2019/11/28 14:44] (current)
jojo1973 Added flags -28 and -29
@@ Line 1: / Line 1: @@
 ==== DROP ====
 ----
-<callout color="black" icon="fa fa-indent" title="Stack Diagram">
+<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
-^ Input Stack ^  ^ Output Stack ^
-| **O** | → | <<Empty>> |
-<button modal="stack-legend" size="xs">Legend</button>
-<modal id="stack-legend" size="lg" title="Stack diagram help">
-^ Legend  ^ Object type ^
-| **O**  | Any object |
-| **I**  | Integer number |
-| **R**  | Real number |
-| **Z**  | Complex number |
-| **A**  | Algebraic expression |
-| **N**  | Variable name / identifier |
-| **L**  | List |
-| **V**  | Vector |
-| **M**  | Matrix |
-| **P**  | Program |
-| **Lib** | Library |
-| **G** | Graphics |
-| **U** | Units |
-| **S** | String |
-</modal>
 ----
-| **Command category** | [[..:|Stack]]  |
+Remove one object from the top of the stack
-| **Can be used in symbolics** | No |
+</callout>
-| **Affected by flags** | No |
+<callout color="green" icon="fa fa-indent" title="Stack Diagram">
 ----
-===Description===
+^  __Input Stack__  ^  ^  __Output Stack__  ^
-This command will remove one object from the top of the 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">
 ----
-===Related commands===
+The ''DROP'' command deletes the object on the top of the stack, shifting the remaining ones by one level.
-DROPN DROP2
+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="success" icon="true">
-===Compatibility===
+<callout type="warning" icon="true" title="Compatibility">
-This command is fully compatible with userRPL.
+----
+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="Notes and Examples">
-The following program:
-  « 123 DROP »
+<callout type="info" icon="true" title="Usage">
+----
-Will have no effect on the stack.
+<code>
+:            "This is a string"
+:               { 'X' 'Y' 'Z' }
+:                           1_m
+……………………………………………………………………………………
+DROP
+</code>
+will result in
+<code>
+:            "This is a string"
+:               { '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>