Doc: little changes
This commit is contained in:
+154
-72
@@ -904,16 +904,26 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">1.0</code><br>
|
||||
<code class="green">1</code><br>
|
||||
<code>>>></code> <code class="blue">0.123</code><br>
|
||||
<code class="green">0.123</code><br>
|
||||
<code>>>></code> <code class="blue">4.5e+3</code><br>
|
||||
<code class="green">4500</code><br>
|
||||
<code>>>></code> <code class="blue">4.5E-33</code><br>
|
||||
<code class="green">4.5e-33</code><br>
|
||||
<code>>>></code> <code class="blue">4.5E-3</code><br>
|
||||
<code class="green">0.0045</code><br>
|
||||
<code>>>></code> <code class="blue">4.5E10</code><br>
|
||||
<code class="green">1</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">0.123</code><br>
|
||||
<code class="green">0.123</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">4.5e+3</code><br>
|
||||
<code class="green">4500</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">4.5E-33</code><br>
|
||||
<code class="green">4.5e-33</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">4.5E-3</code><br>
|
||||
<code class="green">0.0045</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">4.5E10</code><br>
|
||||
<code class="green">4.5e+10</code></p>
|
||||
</div>
|
||||
<table class="tableblock frame-all grid-all stretch">
|
||||
@@ -985,22 +995,38 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">1 | 2</code><br>
|
||||
<code class="green">1|2</code><br>
|
||||
<code>>>></code> <code class="blue">4|6</code> <em class="gray">// Fractions are always reduced to their lowest terms</em><br>
|
||||
<code class="green">2|3</code><br>
|
||||
<code>>>></code> <code class="blue">1|2 + 2|3</code><br>
|
||||
<code class="green">7|6</code><br>
|
||||
<code>>>></code> <code class="blue">1|2 * 2|3</code><br>
|
||||
<code class="green">1|3</code><br>
|
||||
<code>>>></code> <code class="blue">1|2 / 1|3</code><br>
|
||||
<code class="green">3|2</code><br>
|
||||
<code>>>></code> <code class="blue">1|2 ./ 1|3</code> <em class="gray">// Force decimal division</em><br>
|
||||
<code class="green">1.5</code><br>
|
||||
<code>>>></code> <code class="blue">-1|2</code><br>
|
||||
<code class="green">-1|2</code><br>
|
||||
<code>>>></code> <code class="blue">1|-2</code> <em class="gray">// Invalid sign specification</em><br>
|
||||
<em class="red">Eval Error: [1:3] infix operator "|" requires two non-nil operands, got 1</em><br>
|
||||
<code>>>></code> <code class="blue">1|(-2)</code><br>
|
||||
<code class="green">1|2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">4|6</code> <em class="gray">// Fractions are always reduced to their lowest terms</em><br>
|
||||
<code class="green">2|3</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1|2 + 2|3</code><br>
|
||||
<code class="green">7|6</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1|2 * 2|3</code><br>
|
||||
<code class="green">1|3</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1|2 / 1|3</code><br>
|
||||
<code class="green">3|2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1|2 ./ 1|3</code> <em class="gray">// Force decimal division</em><br>
|
||||
<code class="green">1.5</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">-1|2</code><br>
|
||||
<code class="green">-1|2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1|-2</code> <em class="gray">// Invalid sign specification</em><br>
|
||||
<em class="red">Eval Error: [1:3] infix operator "|" requires two non-nil operands, got 1</em></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1|(-2)</code><br>
|
||||
<code class="green">-1|2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
@@ -1009,10 +1035,14 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">1|2 + 5</code><br>
|
||||
<code class="green">11|2</code><br>
|
||||
<code>>>></code> <code class="blue">4 - 1|2</code><br>
|
||||
<code class="green">7|2</code><br>
|
||||
<code>>>></code> <code class="blue">1.0 + 1|2</code><br>
|
||||
<code class="green">11|2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">4 - 1|2</code><br>
|
||||
<code class="green">7|2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1.0 + 1|2</code><br>
|
||||
<code class="green">1.5</code></p>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1025,13 +1055,19 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">"I’m a string"</code><br>
|
||||
<code class="green">I’m a string</code><br>
|
||||
<code>>>></code> <code class="blue">"123abc?!"</code><br>
|
||||
<code class="green">123abc?!</code><br>
|
||||
<code>>>></code> <code class="blue">"123\nabc"</code><br>
|
||||
<code class="green">I’m a string</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">"123abc?!"</code><br>
|
||||
<code class="green">123abc?!</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">"123\nabc"</code><br>
|
||||
<code class="green">123</code><br>
|
||||
<code class="green">abc</code><br>
|
||||
<code>>>></code> <code class="blue">"123\tabc"</code><br>
|
||||
<code class="green">abc</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">"123\tabc"</code><br>
|
||||
<code class="green">123    abc</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
@@ -1076,7 +1112,7 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<div class="title">Example 4. Item access syntax</div>
|
||||
<div class="content">
|
||||
<div class="paragraph">
|
||||
<p><em>item</em> = <em>string-expr</em> "<strong>[</strong>" <em>integer-expr</em> "<strong>]</strong>"</p>
|
||||
<p><strong><em>item</em></strong> = <em>string-expr</em> "<strong>[</strong>" <em>integer-expr</em> "<strong>]</strong>"</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1084,23 +1120,33 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<div class="title">Example 5. Sub-string syntax</div>
|
||||
<div class="content">
|
||||
<div class="paragraph">
|
||||
<p><em>sub-string</em> = <em>string-expr</em> "<strong>[</strong>" <em>integer-expr</em> "<strong>:</strong>" <em>integer-expr</em> "<strong>]</strong>"</p>
|
||||
<p><strong><em>sub-string</em></strong> = <em>string-expr</em> "<strong>[</strong>" <em>integer-expr</em> "<strong>:</strong>" <em>integer-expr</em> "<strong>]</strong>"</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">String examples</div>
|
||||
<p><code>>>></code> <code class="blue">s="abcd"</code> <em class="gray">// assign the string to variable s</em><br>
|
||||
<code class="green">"abcd"</code><br>
|
||||
<code>>>></code> <code class="blue">s[1]</code> <em class="gray">// char at position 1 (starting from 0)</em><br>
|
||||
<code class="green">"b"</code><br>
|
||||
<code>>>></code> <code class="blue">s.[-1]</code> <em class="gray">// char at position -1, the rightmost one</em><br>
|
||||
<code class="green">"d"</code><br>
|
||||
<code>>>></code> <code class="blue">#s</code> <em class="gray">// number of chars</em><br>
|
||||
<code class="gren">4</code><br>
|
||||
<code>>>></code> <code class="blue">#"abc"</code> <em class="gray">// number of chars</em><br>
|
||||
<code class="green">3</code><br>
|
||||
<code>>>></code> <code class="blue">s[1:3]</code> <em class="gray">// chars from position 1 to position 3 excluded</em><br>
|
||||
<code class="green">"abcd"</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">s[1]</code> <em class="gray">// char at position 1 (starting from 0)</em><br>
|
||||
<code class="green">"b"</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">s.[-1]</code> <em class="gray">// char at position -1, the rightmost one</em><br>
|
||||
<code class="green">"d"</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">\#s</code> <em class="gray">// number of chars</em><br>
|
||||
<code class="gren">4</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">#"abc"</code> <em class="gray">// number of chars</em><br>
|
||||
<code class="green">3</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">s[1:3]</code> <em class="gray">// chars from position 1 to position 3 excluded</em><br>
|
||||
<code class="grean">"bc"</code></p>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1395,9 +1441,13 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<code class="green">3</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">index=2; ["a", "b", "c", "d"].index</code><br>
|
||||
<p><code>>>></code> <code class="blue">index=2; ["a", "b", "c", "d"][index]</code><br>
|
||||
<code class="green">c</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">["a", "b", "c", "d"][2:]</code><br>
|
||||
<code class="green">["c", "d"]</code></p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_dictionaries"><a class="anchor" href="#_dictionaries"></a><a class="link" href="#_dictionaries">2.5. Dictionaries</a></h3>
|
||||
@@ -1417,14 +1467,13 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="exampleblock">
|
||||
<div class="title">Example 10. Item access syntax</div>
|
||||
<div class="content">
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">{1:"one", 2:"two"}</code><br>
|
||||
<code class="green">{1: "one", 2: "two"}</code><br>
|
||||
<code>>>></code> <code class="blue">{"one":1, "two": 2}</code><br>
|
||||
<code class="green">{"one": 1, "two": 2}</code><br>
|
||||
<code>>>></code> <code class="blue">{"sum":1+2+3, "prod":1*2*3}</code><br>
|
||||
<code class="green">{"sum": 6, "prod": 6}</code></p>
|
||||
<p><strong><em>item</em></strong> = <em>dict-expr</em> "<strong>[</strong>" <em>key-expr</em> "<strong>]</strong>"</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<table class="tableblock frame-all grid-all stretch">
|
||||
<caption class="title">Table 7. Dict operators</caption>
|
||||
@@ -1450,10 +1499,10 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<td class="tableblock halign-left valign-top"><p class="tableblock"><code class="blue">{1:"one"}+{6:"six"}</code> → <em>{1: "one", 6: "six"}</em></p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tableblock halign-center valign-top"><p class="tableblock"><code class="blue">.</code></p></td>
|
||||
<td class="tableblock halign-center valign-top"><p class="tableblock"><code class="blue">[]</code></p></td>
|
||||
<td class="tableblock halign-center valign-top"><p class="tableblock"><em>Dict item value</em></p></td>
|
||||
<td class="tableblock halign-left valign-top"><p class="tableblock">Item value of given key</p></td>
|
||||
<td class="tableblock halign-left valign-top"><p class="tableblock"><code class="blue">{"one":1, "two":2}."two"</code> → <em>2</em></p></td>
|
||||
<td class="tableblock halign-left valign-top"><p class="tableblock"><code class="blue">{"one":1, "two":2}["two"]</code> → <em>2</em></p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tableblock halign-center valign-top"><p class="tableblock"><code class="blue">in</code></p></td>
|
||||
@@ -1464,6 +1513,27 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">{1:"one", 2:"two"}</code><br>
|
||||
<code class="green">{1: "one", 2: "two"}</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">{"one":1, "two": 2}</code><br>
|
||||
<code class="green">{"one": 1, "two": 2}</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">{"sum":1+2+3, "prod":1*2*3}</code><br>
|
||||
<code class="green">{"sum": 6, "prod": 6}</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">{"one":1, "two":2}["two"]</code><br>
|
||||
<code class="green">2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">d={"one":1, "two":2}; d["six"]=6; d</code><br>
|
||||
<code class="green">{"two": 2, "one": 1, "six": 6}</code></p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1474,7 +1544,7 @@ dev-expr <span class="nt">--</span> Expressions calculator v1.10.0<span class="o
|
||||
<p><em>Expr</em>, like most programming languages, supports variables. A variable is an identifier with an assigned value. Variables are stored in <em>contexts</em>.</p>
|
||||
</div>
|
||||
<div class="exampleblock">
|
||||
<div class="title">Example 10. Variable literal syntax</div>
|
||||
<div class="title">Example 11. Variable literal syntax</div>
|
||||
<div class="content">
|
||||
<div class="paragraph">
|
||||
<p><strong><em>variable</em></strong> = <em>identifier</em> "<strong>=</strong>" <em>any-value</em><br>
|
||||
@@ -1498,18 +1568,30 @@ The assign operator <code class="blue">=</code> returns the value assigned to th
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p><code>>>></code> <code class="blue">a=1</code><br>
|
||||
<code class="green">1</code><br>
|
||||
<code>>>></code> <code class="blue">a_b=1+2</code><br>
|
||||
<code class="green">1+2</code><br>
|
||||
<code>>>></code> <code class="blue">a_b</code><br>
|
||||
<code class="green">3</code><br>
|
||||
<code>>>></code> <code class="blue">x = 5.2 * (9-3)</code> <em class="gray">// The assigned value has the approximation error typical of the float data-type</em><br>
|
||||
<code class="green">31.200000000000003</code><br>
|
||||
<code>>>></code> <code class="blue">x = 1; y = 2*x</code><br>
|
||||
<code class="green">2</code><br>
|
||||
<code>>>></code> <code class="blue"><em>a=2</code><br>
|
||||
<code class="red">Parse Error: [1:2] unexpected token "</em>"</code><br>
|
||||
<code>>>></code> <code class="blue">1=2</code><br>
|
||||
<code class="green">1</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">a_b=1+2</code><br>
|
||||
<code class="green">1+2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">a_b</code><br>
|
||||
<code class="green">3</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">x = 5.2 * (9-3)</code> <em class="gray">// The assigned value has the approximation error typical of the float data-type</em><br>
|
||||
<code class="green">31.200000000000003</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">x = 1; y = 2*x</code><br>
|
||||
<code class="green">2</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue"><em>a=2</code><br>
|
||||
<code class="red">Parse Error: [1:2] unexpected token "</em>"</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <code class="blue">1=2</code><br>
|
||||
<code class="red">Parse Error: assign operator ("=") must be preceded by a variable</code></p>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1995,7 +2077,7 @@ These operators have a high priority, in particular higher than the operator <co
|
||||
</div>
|
||||
<div id="footer">
|
||||
<div id="footer-text">
|
||||
Last updated 2024-06-19 22:22:00 +0200
|
||||
Last updated 2024-06-19 22:46:18 +0200
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
|
||||
Reference in New Issue
Block a user