| Both sides previous revision
Previous revision
|
Last revision
Both sides next revision
|
manual:chapter6:stack:cmd_stkpick [2019/10/09 09:44]
claudio |
manual:chapter6:stack:cmd_stkpick [2019/10/19 15:36]
jojo1973 Redone according final template |
| ==== 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<sub>snapshot</sub>** | **I<sub>level</sub>** | **→** | **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#operators|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 (Level 2 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> |