==== DEPTH ====
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Return the number of items present on the stack
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^  ^  __Output Stack__  ^
|  ****  |  **→**  |  **I<sub>depth</sub>**  |
|  //Level 1//  |  //→//  |  //Level 1//  |

{{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}

| **Keyword type**  | [[manual:chapter5:basics#commands|Command]]  ||
| **Parallel list processing capabilities**  | [[manual:chapter5:listproc#group-1commands-that-cannot-parallel-process|Group 1]]  | //Commands that cannot parallel process//  |
| **Affected by flags**  | [[manual:appendix:flags#flag-28|-28]]  | //Enable RPN stack mode//  |
| ::: | [[manual:appendix:flags#flag-29|-29]]  | //RPN stack depth//  |













</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
The ''DEPTH'' command puts on the level 1 of the stack the number of elements present on it before executing the command itself.

When the stack is in RPN mode ''DEPTH'' always returns ''4'' or ''8'', depending on the selected stack depth.
</callout>

<callout type="warning" icon="true" title="Compatibility">
----
''DEPTH'' is not fully equivalent to its **userRPL** counterpart.

In particular:

  * In **userRPL** RPN stack mode is not supported.
</callout>

<callout type="info" icon="true" title="Usage">
----
**__Input__**
<code>
4:                                      
3:                                   1_m
2:                       { 'X' 'Y' 'Z' }
1:                    "This is a string"
…………………………………………………………………………………………………………
DEPTH                                   
</code>
\\
**__Output__**
<code>
4:                                   1_m
3:                       { 'X' 'Y' 'Z' }
2:                    "This is a string"
1:                                     3
…………………………………………………………………………………………………………
                                        
</code>
</callout>

<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
----
{{page>manual:chapter6:stack&nofooter&noeditbtn&inline}}
</callout>