Category:Guish: Difference between revisions
no edit summary
No edit summary |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
Line 166:
<pre> a = 'my string'; puts "this is: @{a}"
puts "sum of 1 + 5 is: @(
Anything embedded inside '''{}''' is treated as a code block and no variable substitution is done at definition time.
Line 209:
<pre> a = 1
after 4 {a = 0}
while {eq(@a, 1)} {
wait 1 puts 'true'
}
Line 282:
; '''self'''
: variable holding the window id when in signal code.
: refers to the block in which there are positional arguments and function arguments (alternative syntax).
; '''FILE'''
: variable holding the path of current source file.
Line 321 ⟶ 323:
; '''=> <signal> <subcmd>'''
: register a sub-command <subcmd> to run when <signal> triggers. For normal signals (eg. signals tied to elements), there must exist an implied subject.
; '''
: unregister a sub-command <subcmd> previously registered on signal <signal>.
; '''q'''
: quit guish (exit status 0).
Line 444 ⟶ 446:
; '''m <x> <y>'''
: move element to coords <x> <y>.
; '''/ [<l|L|a|A|p|x|n> [<...>]]'''
: draws/fills lines, points and arcs depending on operation (See Drawing operations subsection). Origin coordinates correspond to the bottom-left corner as default Cartesian axes (instead of upper-left one used for windows/elements). If no operation is given, then all drawings are discarded from the implied element.
; '''A <element> <alignment>'''
Line 465 ⟶ 467:
; '''l [<color> <x1> <y1> <x2> <y2> [<...>]]'''
: draws lines between given points using color <color> (beware this command consumes all the phrase). If no arguments are given, then all element lines are discarded.
; '''L [<color> <x1> <y1> <x2> <y2> [<...>]]'''
: fills the polygon described by given points using color <color> (beware this command consumes all the phrase). If no arguments are given, then all filled polygons are discarded.
; '''a [<color> <x> <y> <w> <h> <alpha> <beta> [<...>]]'''
: draws an arc using color <color> and whose "center" is at <x> <y>, major and minor axes are respectively <w> and <h>, start and stop angles are <alpha> and <beta> (consumes all the phrase). If no arguments are given, then all element arcs are discarded.
; '''A [<color> <x> <y> <w> <h> <alpha> <beta> [<...>]]'''
: fills an arc using color <color> and whose "center" is at <x> <y>, major and minor axes are respectively <w> and <h>, start and stop angles are <alpha> and <beta> (consumes all the phrase). If no arguments are given, then all element arcs are discarded.
; '''p [<color> [<...>]]'''
: draws given points using color <color> (beware this command consumes all the phrase). If no arguments are given, then all points are discarded.
: draws given pixels using color <color> (beware this command consumes all the phrase). If no arguments are given, then all pixels are discarded.
; '''n [<color> <name> <x> <y>]'''
: draws given point using color <color> and putting the text <name> at that point. If no arguments are given, then all points are discarded.
Line 630 ⟶ 634:
Every phrase is reduced to an empty phrase while evaluating:
<pre> a
This example is composed by 2 phrases, and the code block in each phrase is executed before each assignment.
Line 654 ⟶ 658:
With the '''=''' operator (actually, it's a special statement command), it's possible to assign
<pre> b = 123; puts
There are two methods to define/create empty variables: by explicitely assing an empty string to a variable (ex. a = "") or by simply omit the value (ex. a =).
In addition, if there is more than one value to assign, a block is automatically created (embedding those values) and assigned to that variable:
<pre> a = 1 # this simply assigns '1' to the variable 'a'
b = 1, 2, 3, 4 # this instead assigns the block '{1, 2, 3, 4}' to the variable 'a'
c = {1, 2, 3, 4} # same but explicit</pre>
Each block has it's own scope, and variable resolution works by searching from the last scope to the first. Ex:
Line 721 ⟶ 730:
; '''<s> .. <e>'''
: returns integers starting at <s> and ending at <e> (inclusive) as multiple tokens.
; '''<var> = [<val>, [<val1>, ...]]'''
: defines a variable (consumes all the phrase). If no value is given, an empty token is assigned to the variable. If a single value is given, that value is assigned to the variable. If multiple values are given, then all these values are wrapped inside a block, and this block is assigned to the variable.
; '''<attr> .= [<val>, [<val1>, ...]]'''
: defines an element using the implied subject attribute (consumes all the phrase). If no value is given, an empty token is assigned to the variable. If a single value is given, that value is assigned to the variable. If multiple values are given, then all these values are wrapped inside a block, and this block is assigned to the variable.
== Unary ==
Line 732 ⟶ 741:
; '''@<varname|num>'''
: dereferences a variable name (or positional argument).
; '''@*'''
: returns all function parameters as tokens (usable with command line parameters too).
Line 799 ⟶ 806:
; '''eval(...)'''
: evaluates code by first stringifying all given arguments and then returns the result of evaluation if any. Beware that this function runs in the "current" scope, and can modify it.
; '''builtin(<func>, ...)'''
: gets the name of a builtin function and a variable number of arguments, then calls the builtin function with those arguments and returns the result (if any). It's useful when overriding builtin functions.
Line 815 ⟶ 820:
; '''if(<cond>, [<v1>, [<v2>]])'''
: if <cond> is true and <v1> is given, returns <v1>, else if <cond> is false and <v2> is given, returns <v2>.
; '''unless(<cond>, [<v1>, [<v2>]])'''
: if <cond> is false and <v1> is given, returns <v1>, else if <cond> is true and <v2> is given, returns <v2>.
: returns the first true argument; if there are no true arguments, returns the last one which is false.
: returns the last true argument if all arguments are true, otherwise returns the first false argument.
; '''flat(...)'''
: returns all given arguments; if a block is found, then it is flatted.
Line 831 ⟶ 842:
; '''popb()'''
: pops the first argument from function arguments (works with command line parameters too). This function is somewhat special, as if there are no arguments to pop.
▲; '''slice(<si>, <ei>, ...)'''
; '''times(<n>, <arg>)'''
: returns a sequence of tokens made by <n> times <arg>. This function is somewhat special, as when there are 0 tokens to replicate, it'll return nothing (statement behaviour).
; '''get(<name>)'''
: returns the value of the variable with name <name>, or an empty token if the variable does not exist.
; '''true(<arg>)'''
: returns 1 if <arg> is true, 0 otherwise.
Line 865 ⟶ 872:
; '''seq(<t1>, <t2>, ...)'''
: returns 1 if all arguments are equal (string comparison), 0 otherwise.
▲; '''count(...)'''
▲; '''any(...)'''
▲: returns the first true argument; if there are no true arguments, returns the last one which is false. This function is special, as the evaluation will be interrupted as soon as there is at least 1 true argument.
▲; '''all(...)'''
▲: returns the last true argument if all arguments are true, otherwise returns the first false argument. This function is special, as the evaluation will be interrupted as soon as there is at least 1 false argument.
; '''add(...)'''
: perform addition.
Line 905 ⟶ 906:
; '''xor(<n1>, <n2>, ...)'''
: perform bitwise XOR.
; '''
: perform bitwise AND.
; '''
: perform bitwise OR.
; '''lsh(<n1>, <n2>, ...)'''
| |||