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 [2019/09/13 13:41]
jojo1973 First attempt at templqte redesign
manual:chapter6:stack:cmd_drop [2019/11/28 14:44]
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__  ^ +Remove one object from the top of the stack 
-|  **O**  |  →  |  | +</callout>
-|  //Level 1//  |  **→**  |  //Level 1/ +
  
 +<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}} {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}
  
- +|**Type**| [[manual:chapter5:basics#commands|Command]]  || 
-| **Can be used in symbolics** |  No  | +|**Parallel list processing**| [[manual:chapter5:listproc#group-2commands-that-must-use-dolist-to-parallel-process|Group 2]]  ||  
-| **Affected by flags** |  No  | +|**Affected by flags**|  [[manual:appendix:flags#flag-28|-28]] | RPL / RPN stack mode  | 
-**Supports parallel list processing ** |  No  |+|:::|  [[manual:appendix:flags#flag-29|-29]] | RPN stack depth  |
 </callout> </callout>
  
-<callout type="primary" icon="fa fa-comment" title="Description">+<callout color="orangered" icon="fa fa-comment" title="Description">
 ---- ----
-This command will remove one object from the top of 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="success" icon="true" title="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">+<callout type="info" icon="true" title="Usage">
 ---- ----
-The following program: 
 <code> <code>
-  « 123 456 789 DROP »+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> </code>
-leaves ''123'' and ''456'' on the stack.   
 </callout> </callout>
  
-<callout color="black" title="Related Commands">+<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands"> 
 +----
 {{page>manual:chapter6:stack&nofooter&noeditbtn&inline}} {{page>manual:chapter6:stack&nofooter&noeditbtn&inline}}
 </callout> </callout>
  • manual/chapter6/stack/cmd_drop.txt
  • Last modified: 2019/11/28 14:44
  • by jojo1973