mirror of https://github.com/svaarala/duktape.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
60 lines
1.4 KiB
60 lines
1.4 KiB
<h2 id="notation">Notation</h2>
|
|
|
|
<h3>Value stacks</h3>
|
|
|
|
<p>This document uses the following stack notation. Stacks are represented
|
|
visually with the stack growing to the right. For instance, after:</p>
|
|
|
|
<pre class="c-code">
|
|
duk_push_number(ctx, 123);
|
|
duk_push_string(ctx, "foo");
|
|
duk_push_true(ctx);
|
|
</pre>
|
|
|
|
<p>the stack would look like:</p>
|
|
|
|
<pre class="stack">
|
|
[ 123 "foo" true ]
|
|
</pre>
|
|
|
|
<p>The elements on the stack which don't affect the operation are denoted
|
|
with a single element with ellipsis ("..."):</p>
|
|
|
|
<pre class="stack">
|
|
[ ... ]
|
|
</pre>
|
|
|
|
<p>The elements actively operated on, either being read, written, inserted,
|
|
or removed, have a white background:</p>
|
|
|
|
<pre class="stack">
|
|
[ ... obj! key! ]
|
|
</pre>
|
|
|
|
<p>Elements which are identified by an explicit index are indicated with a
|
|
separate color and an additional ellipsis, to emphasize that they may be
|
|
anywhere in the stack:</p>
|
|
|
|
<pre class="stack">
|
|
[ ... obj* ... key! value! ]
|
|
</pre>
|
|
|
|
<p>However, if the explicitly indexed element is modified, it is also
|
|
shown with a white background:</p>
|
|
|
|
<pre class="stack">
|
|
[ ... obj! ... key! value! ]
|
|
</pre>
|
|
|
|
<p>In some cases the index of an element may be emphasized with a number
|
|
or symbolic value in parenthesis:</p>
|
|
<pre class="stack">
|
|
[ ... val(index)! val(index+1)! ... ]
|
|
</pre>
|
|
|
|
<p>Stack transformation is represented with an arrow and two stacks:</p>
|
|
|
|
<pre class="stack">
|
|
[ ... obj ... key! value! ] -> [ ... obj ... ]
|
|
</pre>
|
|
|
|
|