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/10/01 15:40]
jojo1973 Removed duplicate description
manual:chapter6:stack:cmd_drop [2019/11/28 14:44] (current)
jojo1973 Added flags -28 and -29
Line 1: Line 1:
 ==== DROP ==== ==== DROP ====
 ---- ----
-<callout type="primary" color="" icon="fa fa-comment" title="Description">+<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
 ---- ----
-This command will remove one object from the top of the stack.+Remove one object from the top of the stack
 </callout> </callout>
  
-<callout color="crimson" icon="fa fa-indent" title="Stack Diagram">+<callout color="green" icon="fa fa-indent" title="Stack Diagram">
 ---- ----
 ^  __Input Stack__  ^  ^  __Output Stack__  ^ ^  __Input Stack__  ^  ^  __Output Stack__  ^
 |  **O**  |  **→**  |  | |  **O**  |  **→**  |  |
-|  //Level 1//  |  ****   //Level 1//  | +|  //Level 1//  |  ////   //Level 1//  | 
  
 {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}} {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}
  
-{{fa>times?lg&color=red}} **Support for inclusion in symbolic expressions**  |   +|**Type**| [[manual:chapter5:basics#commands|Command]]  || 
-{{fa>times?lg&color=red}} **Support for parallel list processing**  |  +|**Parallel list processing**| [[manual:chapter5:listproc#group-2commands-that-must-use-dolist-to-parallel-process|Group 2]]  ||  
-{{fa>times?lg&color=red}} **Affected by flags**  |  +|**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="success" icon="true" title="Compatibility">+<callout color="orangered" icon="fa fa-comment" title="Description">
 ---- ----
-This command is fully compatible with userRPL.+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>
  
 <callout type="info" icon="true" title="Usage"> <callout type="info" icon="true" title="Usage">
 ---- ----
-The following program: 
 <code> <code>
-  «  +3:            "This is a string" 
-    123 +2:               { 'X' 'Y' 'Z' } 
-    456 +1:                           1_m 
-    789 +…………………………………………………………………………………… 
-    DROP +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="darkslategray" icon="fa fa-hand-o-right" 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.1569969623.txt.gz
  • Last modified: 2019/10/01 15:40
  • by jojo1973