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:39]
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>+
 ---- ----
-| **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>
-<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>
-<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> 
 +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>
  
 +<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.1521067181.txt.gz
  • Last modified: 2018/03/14 15:39
  • by claudio