| Both sides previous revision
Previous revision
|
Last revision
Both sides next revision
|
manual:chapter6:stack:cmd_stkdepth [2019/10/09 09:38]
claudio |
manual:chapter6:stack:cmd_stkdepth [2019/10/19 15:44]
jojo1973 Redone according final template |
| ==== STKDEPTH ==== | ==== STKDEPTH ==== |
| ---- | ---- |
| <callout type="primary" color="" icon="fa fa-comment" title="Description"> | <callout type="primary" color="" icon="fa fa-book" title="Synopsis"> |
| ---- | ---- |
| Pushes the depth of a given snapshot from the "stack of stacks". Similar to ''DEPTH'' but choosing which stack snapshot to use. | Push the depth of a given snapshot from the Undo stack on the current 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** | | | **I<sub>snapshot</sub>** | **→** | **I<sub>depth</sub>** | |
| | //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#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 ''STKDEPTH'' command retrieves the depth of a given snapshot on the Undo stack and pushes it on the current 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> |
| « CLEAR | « CLEAR |
| 789 | 789 |
| STKPUSH | STKPUSH |
| 1 STKDEPTH | CLEAR |
| | "ABC" |
| | STKPUSH |
| | CLEAR |
| | 2 STKDEPTH |
| » | » |
| </code> | </code> |
| will push the number 3 on the stack, since the snapshot pushed with ''STKPUSH'' has 3 objects. The argument in Level 1 indicates to use the snapshot on level 1 of the "stack of stacks". | will push the number ''3'' on the stack, since the snapshot on level 2 of the Undo stack has 3 elements in it. |
| </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> |