Doc: progress about builtin modules
This commit is contained in:
+677
-32
@@ -550,7 +550,11 @@ pre.rouge .ss {
|
||||
<ul class="sectlevel3">
|
||||
<li><a href="#_variables">1.1.1. Variables</a></li>
|
||||
<li><a href="#_multi_expression">1.1.2. Multi-expression</a></li>
|
||||
<li><a href="#_calculation_context">1.1.3. Calculation context</a></li>
|
||||
<li><a href="#_calculation_context">1.1.3. Calculation context</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_inspecting_contexts">Inspecting contexts</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_dev_expr_test_tool">1.2. <code>dev-expr</code> test tool</a></li>
|
||||
@@ -590,20 +594,87 @@ pre.rouge .ss {
|
||||
<li><a href="#_function_context">6.4. Function context</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_iterators">7. Iterators</a>
|
||||
<li><a href="#_builtins">7. Builtins</a>
|
||||
<ul class="sectlevel2">
|
||||
<li><a href="#_operators_on_iterators">7.1. Operators on iterators</a>
|
||||
<li><a href="#_builtin_modules">7.1. Builtin modules</a>
|
||||
<ul class="sectlevel3">
|
||||
<li><a href="#_named_operators">7.1.1. Named operators</a></li>
|
||||
<li><a href="#_module_base">7.1.1. Module "base"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_isbool">isBool()</a></li>
|
||||
<li><a href="#_isdict">isDict()</a></li>
|
||||
<li><a href="#_isfloat">isFloat()</a></li>
|
||||
<li><a href="#_isfract">isFract()</a></li>
|
||||
<li><a href="#_islist">isList()</a></li>
|
||||
<li><a href="#_isnil">isNil()</a></li>
|
||||
<li><a href="#_isrational">isRational()</a></li>
|
||||
<li><a href="#_isstring">isString()</a></li>
|
||||
<li><a href="#_bool">bool()</a></li>
|
||||
<li><a href="#_int">int()</a></li>
|
||||
<li><a href="#_dec">dec()</a></li>
|
||||
<li><a href="#_string">string()</a></li>
|
||||
<li><a href="#_fract">fract()</a></li>
|
||||
<li><a href="#_eval">eval()</a></li>
|
||||
<li><a href="#_var">var()</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_iterator_over_custom_data_sources">7.2. Iterator over custom data-sources</a></li>
|
||||
<li><a href="#_module_fmt">7.1.2. Module "fmt"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_print">print()</a></li>
|
||||
<li><a href="#_println">println()</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_builtins">8. Builtins</a>
|
||||
<li><a href="#_module_import">7.1.3. Module "import"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_import"><em>import()</em></a></li>
|
||||
<li><a href="#_importall"><em>importAll()</em></a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_module_iterator">7.1.4. Module "iterator"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_run">run()</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_module_math_arith">7.1.5. Module "math.arith"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_add">add()</a></li>
|
||||
<li><a href="#_mul">mul()</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_module_os_file">7.1.6. Module "os.file"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_fileopen">fileOpen()</a></li>
|
||||
<li><a href="#_fileappend">fileAppend()</a></li>
|
||||
<li><a href="#_filecreate">fileCreate()</a></li>
|
||||
<li><a href="#_fileclose">fileClose()</a></li>
|
||||
<li><a href="#_filewritetext">fileWriteText()</a></li>
|
||||
<li><a href="#_filereadtext">fileReadText()</a></li>
|
||||
<li><a href="#_filereadtextall">fileReadTextAll()</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_module_string">7.1.7. Module "string"</a>
|
||||
<ul class="sectlevel4">
|
||||
<li><a href="#_strjoin">strJoin()</a></li>
|
||||
<li><a href="#_strsub">strSub()</a></li>
|
||||
<li><a href="#_strsplit">strSplit()</a></li>
|
||||
<li><a href="#_strtrim">strTrim()</a></li>
|
||||
<li><a href="#_strstartswith">strStartsWith()</a></li>
|
||||
<li><a href="#_strendswith">strEndsWith()</a></li>
|
||||
<li><a href="#_strupper">strUpper()</a></li>
|
||||
<li><a href="#_strlower">strLower()</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_iterators">8. Iterators</a>
|
||||
<ul class="sectlevel2">
|
||||
<li><a href="#_builtin_functions">8.1. Builtin functions</a></li>
|
||||
<li><a href="#_import">8.2. <em class="blue">import()</em></a></li>
|
||||
<li><a href="#_operators_on_iterators">8.1. Operators on iterators</a>
|
||||
<ul class="sectlevel3">
|
||||
<li><a href="#_named_operators">8.1.1. Named operators</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_iterator_over_custom_data_sources">8.2. Iterator over custom data-sources</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#_plugins">9. Plugins</a></li>
|
||||
@@ -683,6 +754,43 @@ pre.rouge .ss {
|
||||
<div class="paragraph">
|
||||
<p>Imported functions are registered in the <em>global context</em>. When an expression first calls an imported function, that function is linked to the current context; this can be the <em>main context</em> or a <em>function context</em>.</p>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_inspecting_contexts"><a class="anchor" href="#_inspecting_contexts"></a><a class="link" href="#_inspecting_contexts">Inspecting contexts</a></h5>
|
||||
<div class="paragraph">
|
||||
<p><em>Expr</em> provides the operator <em class="blue">$$</em> that returns the current context. This can be used to inspect the content of the context, for example to check the value of a variable or to see which functions are currently linked to the context. This operator is primarily intended for debugging purposes.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p>An interactive tool could like <code>dev-expr</code> (see <a href="#_dev-expr_test_tool">[_dev-expr_test_tool]</a>) can be used to inspect contexts interactively.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Example: inspecting contexts</div>
|
||||
<p><code>>>></code> <code class="blue">$$</code><br>
|
||||
<code class="green">{"variables": {"ls": "[10, 20, 30]", "it": "$(#3)", "last": "-1"}, "functions": {"about": "about():string{}", "bin": "bin(value, digits=8):integer{}", "ctrl": "ctrl(prop, value):any{}", "ctrlList": "ctrlList():list-of-strings{}", "envGet": "envGet(name):string{}", "envSet": "envSet(name, value):string{}"}}</code><br></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p><code>>>></code> <em class="gray">// Let use the <strong>ml</strong> command to activate multi-line output of contexts, which is more readable.</em><br>
|
||||
<code>>>></code> <code class="blue">ml</code><br>
|
||||
<code>>>></code> <code class="blue">$$</code><br>
|
||||
<code class="green">{</code><br>
|
||||
<code class="green">  "variables": {</code><br>
|
||||
<code class="green">    "last": {"variables": {"last": "-1", "ls": "[10, 20, 30]", "it": "$(#3)"}, "functions": {"ctrlList": "ctrlList():list-of-strings{}", "envGet": "envGet(name):string{}", "envSet": "envSet(name, value):string{}", "about": "about():string{}", "bin": "bin(value, digits=8):integer{}", "ctrl": "ctrl(prop, value):any{}"}},</code><br>
|
||||
<code class="green">    "ls": [10, 20, 30],</code><br>
|
||||
<code class="green">    "it": $(#3)</code><br>
|
||||
<code class="green">  },</code><br>
|
||||
<code class="green">  "functions": {</code><br>
|
||||
<code class="green">    "ctrlList": ctrlList():list-of-strings{},</code><br>
|
||||
<code class="green">    "envGet": envGet(name):string{},</code><br>
|
||||
<code class="green">    "envSet": envSet(name, value):string{},</code><br>
|
||||
<code class="green">    "about": about():string{},</code><br>
|
||||
<code class="green">    "bin": bin(value, digits=8):integer{},</code><br>
|
||||
<code class="green">    "ctrl": ctrl(prop, value):any{}</code><br>
|
||||
<code class="green">  }</code><br>
|
||||
<code class="green">}</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p>In order to inspect the global context issue the <code class="blue">$$global</code> operator.</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
@@ -2578,7 +2686,544 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_iterators"><a class="anchor" href="#_iterators"></a><a class="link" href="#_iterators">7. Iterators</a></h2>
|
||||
<h2 id="_builtins"><a class="anchor" href="#_builtins"></a><a class="link" href="#_builtins">7. Builtins</a></h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph">
|
||||
<p>Builtins are collection of function dedicated to specific domains of application. They are defined in Golang source files called <em>modules</em> and compiled within the <em>Expr</em> package. To make builtins available in <em>Expr</em> contextes, it is required to activate the builtin module in which they are defined.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p>There are currently several builtin modules. More builtin modules will be added in the future.</p>
|
||||
</div>
|
||||
<div class="ulist">
|
||||
<div class="title">Available builtin modules</div>
|
||||
<ul>
|
||||
<li>
|
||||
<p><strong>base</strong>: Base expression tools like isNil(), int(), etc.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong>fmt</strong>: String and console formatting functions</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong>import</strong>: Functions import() and include()</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong>iterator</strong>: Iterator helper functions</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong>math.arith</strong>: Functions add() and mul()</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong>os.file</strong>: Operating system file functions</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong>string</strong>: string utilities</p>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p>Builtins activation is done by using the <code class="blue">BUILTIN</code> operator. All modules except "base" must be explicitly enabled. The syntax is as follows.</p>
|
||||
</div>
|
||||
<div class="exampleblock">
|
||||
<div class="title">Example 16. Builtin activation syntax</div>
|
||||
<div class="content">
|
||||
<div class="paragraph">
|
||||
<p><strong><em>builtin-activation</em></strong> = <code class="blue">BUILTIN</code> (<em>builtin-name</em> | <em>list-of-builtin-names</em>)<br>
|
||||
<em>builtin-name</em> = <em>string</em><br>
|
||||
<em>list-of-builtin-names</em> = <strong>[</strong> <em>string</em> { "<strong>,</strong>" <em>string</em> } <strong>]</strong></p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p>The following example shows how to activate the builtin module "math.arith" and then use the function add() defined in that module.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Example: using built functions</div>
|
||||
<p><code>>>></code> <code class="blue">BUILTIN "math.arith"</code><br>
|
||||
<code class="green">1</code><br>
|
||||
<code>>>></code> <code class="blue">add(5, 3, -2)</code><br>
|
||||
<code class="green">6</code></p>
|
||||
</div>
|
||||
<div class="admonitionblock tip">
|
||||
<table>
|
||||
<tr>
|
||||
<td class="icon">
|
||||
<i class="fa icon-tip" title="Tip"></i>
|
||||
</td>
|
||||
<td class="content">
|
||||
To avoid the need to activate builtin modules one by one, it is possible to activate all builtin modules at once by using the <code class="blue">BUILTIN "*"</code> syntax.
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_builtin_modules"><a class="anchor" href="#_builtin_modules"></a><a class="link" href="#_builtin_modules">7.1. Builtin modules</a></h3>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_base"><a class="anchor" href="#_module_base"></a><a class="link" href="#_module_base">7.1.1. Module "base"</a></h4>
|
||||
<div class="paragraph">
|
||||
<p>The "base" builtin module provides functions for type checking and type conversion. These functions are always available in <em>Expr</em> contexts without the need to activate the "base" module.</p>
|
||||
</div>
|
||||
<div class="ulist">
|
||||
<div class="title">Checking functions</div>
|
||||
<ul>
|
||||
<li>
|
||||
<p><a href="#_isbool">isBool()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_isdict">isDict()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_isfloat">isFloat()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_isfract">isFract()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_islist">isList()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_isnil">isNil()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_isrational">isRational()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_isstring">isString()</a></p>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="ulist">
|
||||
<div class="title">Conversion functions</div>
|
||||
<ul>
|
||||
<li>
|
||||
<p><a href="#_bool">bool()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_int">int()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_dec">dec()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_string">string()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_fract">fract()</a></p>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="ulist">
|
||||
<div class="title">Other functions</div>
|
||||
<ul>
|
||||
<li>
|
||||
<p><a href="#_eval">eval()</a></p>
|
||||
</li>
|
||||
<li>
|
||||
<p><a href="#_var">var()</a></p>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isbool"><a class="anchor" href="#_isbool"></a><a class="link" href="#_isbool">isBool()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isBool(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is boolean, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isBool(true)<br>
|
||||
true<br>
|
||||
>>> isBool(3==2)<br>
|
||||
true</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isdict"><a class="anchor" href="#_isdict"></a><a class="link" href="#_isdict">isDict()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isDict(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is dictionary, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isDict({})<br>
|
||||
true<br>
|
||||
>>> isDict({1: "one", 2: "two"})<br>
|
||||
true<br>
|
||||
>>> isDict(1:"one")<br>
|
||||
Eval Error: denominator must be integer, got string (one)</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isfloat"><a class="anchor" href="#_isfloat"></a><a class="link" href="#_isfloat">isFloat()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isFloat(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is float, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isFloat(4.)<br>
|
||||
true<br>
|
||||
>>> isFloat(4)<br>
|
||||
false<br>
|
||||
>>> isFloat("2.1")<br>
|
||||
false</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isfract"><a class="anchor" href="#_isfract"></a><a class="link" href="#_isfract">isFract()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isFract(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is fraction, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isFract(4.5)<br>
|
||||
false<br>
|
||||
>>> isFract(4:5)<br>
|
||||
true<br>
|
||||
>>> isFract(4)<br>
|
||||
<strong>false</strong><br>
|
||||
>>> isFract(1.(3))<br>
|
||||
true</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_islist"><a class="anchor" href="#_islist"></a><a class="link" href="#_islist">isList()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isList(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is list, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isList([])<br>
|
||||
true<br>
|
||||
>>> isList([1, "2"])
|
||||
true
|
||||
>>> isList(1,2)
|
||||
Eval Error: isList(): too many params — expected 1, got 2</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isnil"><a class="anchor" href="#_isnil"></a><a class="link" href="#_isnil">isNil()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isNil(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is nil, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isNil(nil)
|
||||
true
|
||||
>>> isNil(1)
|
||||
false</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isrational"><a class="anchor" href="#_isrational"></a><a class="link" href="#_isrational">isRational()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isRational(<expr>) → bool</code><br>
|
||||
Returns <em>true</em> if the value type of <em><expr></em> is fraction or int, false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isRational(4.5)<br>
|
||||
false<br>
|
||||
>>> isRational(4:5)<br>
|
||||
true<br>
|
||||
>>> isRational(4)<br>
|
||||
<strong>true</strong><br>
|
||||
>>> isRational(1.(3))<br>
|
||||
true</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_isstring"><a class="anchor" href="#_isstring"></a><a class="link" href="#_isstring">isString()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>isString(<expr>) → bool</code><br>
|
||||
Returns a boolean value , false otherwise.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> isString("ciao")<br>
|
||||
true<br>
|
||||
>>> isString(2)<br>
|
||||
false<br>
|
||||
>>> isString(2+"2")<br>
|
||||
true</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_bool"><a class="anchor" href="#_bool"></a><a class="link" href="#_bool">bool()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>bool(<expr>) → bool</code><br>
|
||||
Returns a <em>boolean</em> value consisent to the value of the expression.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> bool(1)
|
||||
true
|
||||
>>> bool(0)
|
||||
false
|
||||
>>> bool("")
|
||||
false
|
||||
>>> bool([])
|
||||
false
|
||||
>>> bool([1])
|
||||
true
|
||||
>>> bool({})
|
||||
false
|
||||
>>> bool({1: "one"})
|
||||
true</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_int"><a class="anchor" href="#_int"></a><a class="link" href="#_int">int()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>int(<expr>) → int</code><br>
|
||||
Returns an <em>integer</em> value consistent with the value of the expression.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> int(2)<br>
|
||||
2<br>
|
||||
>>> int("2")<br>
|
||||
2<br>
|
||||
>>> int("0x1")<br>
|
||||
Eval Error: strconv.Atoi: parsing "0x1": invalid syntax<br>
|
||||
>>> int(0b10)<br>
|
||||
2<br>
|
||||
>>> int(0o2)<br>
|
||||
2<br>
|
||||
>>> int(0x2)<br>
|
||||
2<br>
|
||||
>>> int(1.8)<br>
|
||||
1<br>
|
||||
>>> int(5:2)<br>
|
||||
2<br>
|
||||
>>> int([])<br>
|
||||
Eval Error: int(): can’t convert list to int+
|
||||
>>> int(true)<br>
|
||||
1<br>
|
||||
>>> int(false)<br>
|
||||
0</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_dec"><a class="anchor" href="#_dec"></a><a class="link" href="#_dec">dec()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>dec(<expr>) → float</code><br>
|
||||
Returns a <em>float</em> value consistent with the value of the expression.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> dec(2)<br>
|
||||
2<br>
|
||||
>>> dec(2.1)<br>
|
||||
2.1<br>
|
||||
>>> dec(2.3(1))<br>
|
||||
2.311111111111111<br>
|
||||
>>> dec("3.14")<br>
|
||||
3.14<br>
|
||||
>>> dec(3:4)<br>
|
||||
0.75<br>
|
||||
>>> dec(true)<br>
|
||||
1<br>
|
||||
>>> dec(false)<br>
|
||||
0</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_string"><a class="anchor" href="#_string"></a><a class="link" href="#_string">string()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>string(<expr>) → string</code><br>
|
||||
Returns a <em>string</em> value consistent with the value of the expression.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> string(2)<br>
|
||||
"2"<br>
|
||||
>>> string(0.8)<br>
|
||||
"0.8"<br>
|
||||
>>> string([1,2])<br>
|
||||
"[1, 2]"<br>
|
||||
>>> string({1: "one", 2: "two"})<br>
|
||||
"{1: "one", 2: "two"}"<br>
|
||||
>>> string(2:5)<br>
|
||||
"2:5"<br>
|
||||
>>> string(3==2)<br>
|
||||
"false"</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_fract"><a class="anchor" href="#_fract"></a><a class="link" href="#_fract">fract()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>fract(<expr>) → fraction</code><br>
|
||||
Returns a <em>fraction</em> value consistent with the value of the expression.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> fract(2)<br>
|
||||
2:1<br>
|
||||
>>> fract(2.5)<br>
|
||||
5:2<br>
|
||||
>>> fract("2.5")<br>
|
||||
5:2<br>
|
||||
>>> fract(1.(3))<br>
|
||||
4:3<br>
|
||||
>>> fract([2])<br>
|
||||
Eval Error: fract(): can’t convert list to float<br>
|
||||
>>> fract(false)<br>
|
||||
0:1<br>
|
||||
>>> fract(true)<br>
|
||||
1:1</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_eval"><a class="anchor" href="#_eval"></a><a class="link" href="#_eval">eval()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax: <code>eval(<string-expr>) → any</code><br>
|
||||
Computes and returns the value of the <span class="underline">string</span> expression.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> eval( "2 + fract(1.(3))" )<br>
|
||||
10:3</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_var"><a class="anchor" href="#_var"></a><a class="link" href="#_var">var()</a></h5>
|
||||
<div class="paragraph">
|
||||
<p>Syntax:<br>
|
||||
<code>    var(<string-expr>, <expr>) → any</code><br>
|
||||
<code>    var(<string-expr>) → any</code></p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<p>This function allows you to define variables whose names must include special characters. The first form of the function allows you to define a variable with a name specified by the first parameter and assign it the value of the second parameter. The second form only returns the value of the variable with the specified name.</p>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Examples</div>
|
||||
<p>>>> var("$x", 3+9)<br>
|
||||
12<br>
|
||||
>>> var("$x")<br>
|
||||
12<br>
|
||||
>>> var("gain%", var("$x"))<br>
|
||||
12<br>
|
||||
>>> var("gain%", var("$x")+1)<br>
|
||||
13</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_fmt"><a class="anchor" href="#_module_fmt"></a><a class="link" href="#_module_fmt">7.1.2. Module "fmt"</a></h4>
|
||||
<div class="sect4">
|
||||
<h5 id="_print"><a class="anchor" href="#_print"></a><a class="link" href="#_print">print()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_println"><a class="anchor" href="#_println"></a><a class="link" href="#_println">println()</a></h5>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_import"><a class="anchor" href="#_module_import"></a><a class="link" href="#_module_import">7.1.3. Module "import"</a></h4>
|
||||
<div class="sect4">
|
||||
<h5 id="_import"><a class="anchor" href="#_import"></a><a class="link" href="#_import"><em>import()</em></a></h5>
|
||||
<div class="paragraph">
|
||||
<p><em class="blue">import(<span class="grey"><source-file></span>)</em> — loads the multi-expression contained in the specified source and returns its value.</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_importall"><a class="anchor" href="#_importall"></a><a class="link" href="#_importall"><em>importAll()</em></a></h5>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_iterator"><a class="anchor" href="#_module_iterator"></a><a class="link" href="#_module_iterator">7.1.4. Module "iterator"</a></h4>
|
||||
<div class="sect4">
|
||||
<h5 id="_run"><a class="anchor" href="#_run"></a><a class="link" href="#_run">run()</a></h5>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_math_arith"><a class="anchor" href="#_module_math_arith"></a><a class="link" href="#_module_math_arith">7.1.5. Module "math.arith"</a></h4>
|
||||
<div class="sect4">
|
||||
<h5 id="_add"><a class="anchor" href="#_add"></a><a class="link" href="#_add">add()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_mul"><a class="anchor" href="#_mul"></a><a class="link" href="#_mul">mul()</a></h5>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_os_file"><a class="anchor" href="#_module_os_file"></a><a class="link" href="#_module_os_file">7.1.6. Module "os.file"</a></h4>
|
||||
<div class="sect4">
|
||||
<h5 id="_fileopen"><a class="anchor" href="#_fileopen"></a><a class="link" href="#_fileopen">fileOpen()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_fileappend"><a class="anchor" href="#_fileappend"></a><a class="link" href="#_fileappend">fileAppend()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_filecreate"><a class="anchor" href="#_filecreate"></a><a class="link" href="#_filecreate">fileCreate()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_fileclose"><a class="anchor" href="#_fileclose"></a><a class="link" href="#_fileclose">fileClose()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_filewritetext"><a class="anchor" href="#_filewritetext"></a><a class="link" href="#_filewritetext">fileWriteText()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_filereadtext"><a class="anchor" href="#_filereadtext"></a><a class="link" href="#_filereadtext">fileReadText()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_filereadtextall"><a class="anchor" href="#_filereadtextall"></a><a class="link" href="#_filereadtextall">fileReadTextAll()</a></h5>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_module_string"><a class="anchor" href="#_module_string"></a><a class="link" href="#_module_string">7.1.7. Module "string"</a></h4>
|
||||
<div class="sect4">
|
||||
<h5 id="_strjoin"><a class="anchor" href="#_strjoin"></a><a class="link" href="#_strjoin">strJoin()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strsub"><a class="anchor" href="#_strsub"></a><a class="link" href="#_strsub">strSub()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strsplit"><a class="anchor" href="#_strsplit"></a><a class="link" href="#_strsplit">strSplit()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strtrim"><a class="anchor" href="#_strtrim"></a><a class="link" href="#_strtrim">strTrim()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strstartswith"><a class="anchor" href="#_strstartswith"></a><a class="link" href="#_strstartswith">strStartsWith()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strendswith"><a class="anchor" href="#_strendswith"></a><a class="link" href="#_strendswith">strEndsWith()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strupper"><a class="anchor" href="#_strupper"></a><a class="link" href="#_strupper">strUpper()</a></h5>
|
||||
|
||||
</div>
|
||||
<div class="sect4">
|
||||
<h5 id="_strlower"><a class="anchor" href="#_strlower"></a><a class="link" href="#_strlower">strLower()</a></h5>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_iterators"><a class="anchor" href="#_iterators"></a><a class="link" href="#_iterators">8. Iterators</a></h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph">
|
||||
<p>Iterators are objects that can be used to traverse collections, such as lists and dictionaries. They are created by providing a <em>data-source</em> object, the collection, in a <code>$(<data-source>)</code> expression. Once an iterator is created, it can be used to access the elements of the collection one by one.</p>
|
||||
@@ -2590,7 +3235,7 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
<p>Lists and, soon, dictionaries, are implicit data-sources. The syntax for creating an iterator is as follows.</p>
|
||||
</div>
|
||||
<div class="exampleblock">
|
||||
<div class="title">Example 16. Iterator creation syntax</div>
|
||||
<div class="title">Example 17. Iterator creation syntax</div>
|
||||
<div class="content">
|
||||
<div class="paragraph">
|
||||
<p><strong><em>iterator</em></strong> = "<strong>$(</strong>" <em>data-source</em> "<strong>)</strong>"<br>
|
||||
@@ -2613,7 +3258,7 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
<code class="red">Eval Error: EOF</code></p>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_operators_on_iterators"><a class="anchor" href="#_operators_on_iterators"></a><a class="link" href="#_operators_on_iterators">7.1. Operators on iterators</a></h3>
|
||||
<h3 id="_operators_on_iterators"><a class="anchor" href="#_operators_on_iterators"></a><a class="link" href="#_operators_on_iterators">8.1. Operators on iterators</a></h3>
|
||||
<div class="paragraph">
|
||||
<p>The above example shows the use of the <code class="blue">++</code> operator to get the next element of an iterator. The <code class="blue">++</code> operator is a postfix operator that can be used with iterators. It returns the next element of the collection and updates the state of the iterator. When there are no more elements to iterate over, it returns the error <em class="red">Eval Error: EOF</em>.</p>
|
||||
</div>
|
||||
@@ -2632,7 +3277,7 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
<code class="green">"one"</code></p>
|
||||
</div>
|
||||
<div class="sect3">
|
||||
<h4 id="_named_operators"><a class="anchor" href="#_named_operators"></a><a class="link" href="#_named_operators">7.1.1. Named operators</a></h4>
|
||||
<h4 id="_named_operators"><a class="anchor" href="#_named_operators"></a><a class="link" href="#_named_operators">8.1.1. Named operators</a></h4>
|
||||
<div class="paragraph">
|
||||
<p>Named operators are operators that are identified by a name instead of a symbol. They are implicitly defined and can be called using a special syntax. For example, the <code class="blue">++</code> has the equivalent named operator <code class="blue">.next</code>.</p>
|
||||
</div>
|
||||
@@ -2648,8 +3293,26 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
<li>
|
||||
<p><strong><em>.reset</em></strong>: resets the state of the iterator to the initial state.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong><em>.count</em></strong>: returns the number of elements in the iterator, if it can be determined.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><strong><em>.index</em></strong>: returns the index of the current element in the iterator. Before the first use of the <code class="blue">++</code> operator, it returns the error <em class="red">-1</em>.</p>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="admonitionblock tip">
|
||||
<table>
|
||||
<tr>
|
||||
<td class="icon">
|
||||
<i class="fa icon-tip" title="Tip"></i>
|
||||
</td>
|
||||
<td class="content">
|
||||
Iterators built on custom data-sources can provide additional named operators, depending on the functionality they want to expose. For example, an iterator over a list could provide a named operator called <code class="blue">.reverse</code> that returns the next element of the collection in reverse order.
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<div class="paragraph">
|
||||
<div class="title">Example: using the named operators</div>
|
||||
<p><code>>>></code> <code class="blue">it = $(["one", "two", "three"])</code><br>
|
||||
@@ -2670,7 +3333,7 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_iterator_over_custom_data_sources"><a class="anchor" href="#_iterator_over_custom_data_sources"></a><a class="link" href="#_iterator_over_custom_data_sources">7.2. Iterator over custom data-sources</a></h3>
|
||||
<h3 id="_iterator_over_custom_data_sources"><a class="anchor" href="#_iterator_over_custom_data_sources"></a><a class="link" href="#_iterator_over_custom_data_sources">8.2. Iterator over custom data-sources</a></h3>
|
||||
<div class="paragraph">
|
||||
<p>It is possible to create iterators over custom data-sources by defining a dictionary that has the key <code>next</code> whose value is a function that returns the next element of the collection and updates the state of the iterator. The syntax for creating an iterator over a custom data-source is as follows.</p>
|
||||
</div>
|
||||
@@ -2681,24 +3344,6 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_builtins"><a class="anchor" href="#_builtins"></a><a class="link" href="#_builtins">8. Builtins</a></h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph">
|
||||
<p><mark>TODO: builtins</mark></p>
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_builtin_functions"><a class="anchor" href="#_builtin_functions"></a><a class="link" href="#_builtin_functions">8.1. Builtin functions</a></h3>
|
||||
|
||||
</div>
|
||||
<div class="sect2">
|
||||
<h3 id="_import"><a class="anchor" href="#_import"></a><a class="link" href="#_import">8.2. <em class="blue">import()</em></a></h3>
|
||||
<div class="paragraph">
|
||||
<p><em class="blue">import(<span class="grey"><source-file></span>)</em> loads the multi-expression contained in the specified source and returns its value.</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sect1">
|
||||
<h2 id="_plugins"><a class="anchor" href="#_plugins"></a><a class="link" href="#_plugins">9. Plugins</a></h2>
|
||||
<div class="sectionbody">
|
||||
<div class="paragraph">
|
||||
@@ -2709,7 +3354,7 @@ The clone modifier <code class="blue">@</code> does not make a variable a refere
|
||||
</div>
|
||||
<div id="footer">
|
||||
<div id="footer-text">
|
||||
Last updated 2026-04-15 19:26:58 +0200
|
||||
Last updated 2026-04-18 12:01:15 +0200
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
|
||||
Reference in New Issue
Block a user