Next revision
|
Previous revision
|
manual:chapter6:stack:cmd_stkpick [2019/10/09 09:08] claudio created |
manual:chapter6:stack:cmd_stkpick [2019/10/22 15:24] jojo1973 Fixed internal link |
==== STKPICK ==== | ==== STKPICK ==== |
---- | ---- |
<callout type="primary" color="" icon="fa fa-comment" title="Description"> | <callout type="primary" color="" icon="fa fa-book" title="Synopsis"> |
---- | ---- |
Copy an object from a snapshot in a given level of the "stack of stacks" onto the current stack. Similar to ''PICK'' but selecting which snapshot to pick from. | Pick an object from a snapshot in a given level of the Undo 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__ ^ |
| **I** **I** | **→** | **O** | | | **I<sub>snapshot</sub>** | **I<sub>level</sub>** | **→** | **O** | |
| //Level 2// //Level 1// | **→** | //Level 1// | | | //Level 2// | //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-1commands-that-cannot-parallel-process|Group 1]] || |
| {{fa>times?lg&color=red}} **Affected by flags** | | |**Affected by flags**| None || |
</callout> | </callout> |
| |
<callout type="warning" icon="fa fa-thumbs-down" title="Compatibility"> | <callout color="orangered" icon="fa fa-comment" title="Description"> |
---- | ---- |
This command is new in newRPL, does not exist in userRPL. | The ''STKPICK'' command retrieves an object at a given level from a given snapshot on the Undo stack. |
| |
| The command has little utility in interactive mode, since each time a command is typed and ''[[manual:chapter6:operators:cmd_ovr_xeq|XEQ]]''ted a snapshot of the stack is pushed on the Undo stack, altering the position of the intended snapshot. |
| </callout> |
| |
| <callout type="danger" icon="true" title="Compatibility"> |
| ---- |
| This command is new in newRPL and does not exist in userRPL. |
</callout> | </callout> |
| |
<callout type="info" icon="true" title="Usage"> | <callout type="info" icon="true" title="Usage"> |
---- | ---- |
The following program: | The following program |
<code> | <code> |
« 10 11 12 13 | « 10 11 12 13 |
STKPUSH | STKPUSH |
CLEAR | CLEAR |
1 3 STKPICK | "ABC" |
| STKPUSH |
| CLEAR |
| 2 3 STKPICK |
» | » |
</code> | </code> |
the code will ''PICK'' the third element (Level 1 argument) from snapshot on level 1 (second argument) of the "stack of stacks", resulting in the number 11 being left on the current stack. | will ''[[manual:chapter6:stack:cmd_pick|PICK]]'' the third element (level 1 argument) from snapshot on level 2 (Level 2 argument) of the Undo stack, resulting in the number ''11'' being left on the current 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> |