manual:chapter6:stack:cmd_drop

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:chapter6:stack:cmd_drop [2018/03/14 15:29]
claudio
manual:chapter6:stack:cmd_drop [2019/11/28 14:44] (current)
jojo1973 Added flags -28 and -29
Line 1: Line 1:
 ==== DROP ==== ==== 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>+
 ---- ----
-===Description=== +Remove one object from the top of the stack
-This command will remove one object from the top of the stack+
-===Related commands=== +
-DROPN DROP2+
 </callout> </callout>
-<callout type="success" icon="true"> + 
-===Compatibility=== +<callout color="green" icon="fa fa-indent" title="Stack Diagram"> 
-This command is fully compatible with userRPL.+---- 
 +^  __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>
-<callout type="info" icon="true" title="Notes and Examples"> 
-The following program: 
  
-  « 123 DROP » +<callout color="orangered" icon="fa fa-comment" title="Description"> 
-   +---- 
-Will have no effect on the stack.  +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>
  
 +<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>
  • manual/chapter6/stack/cmd_drop.1521066565.txt.gz
  • Last modified: 2018/03/14 15:29
  • by claudio