Reuh/candran
1
0
Fork 0
mirror of https://github.com/Reuh/candran.git synced 2025-10-27 17:59:30 +00:00
Code Releases Activity

Updated README and tests

Browse source
This commit is contained in:
Étienne Fildadut 2017-08-31 19:40:12 +02:00
parent 70d3aba121
commit 91f72e6d17
2 changed files with 116 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

24
README.md
View file

@ -38,10 +38,12 @@ local list = [ -- table comprehension (kind of)
if i%2 == 0 then
continue -- continue keyword
end
i
i -- implicit push
end
]
local count = [for i=1,10 i] -- single line statements
local a = if condition then "one" else "two" end -- statement as expressions
````
@ -86,6 +88,8 @@ All theses operators can also be put right of the assigment operator, in which c
If you feel like writing hard to understand code, right and left operator can be used at the same time.
**Please note** that the Lua code `a=-1` will be compiled into `a = 1 - a` and not `a = -1`! Write good code, write spaced code: `a = -1` works as expected.
##### Default function parameters
```lua
function foo(bar = "default", other = thing.do())
@ -170,7 +174,7 @@ Add one or more value to the returned value list. If you use a `return` afterwar
This keyword is mainly useful when used through implicit `push` with table comprehension and statement expressions.
**Please note** that, in order to stay compatible with vanilla Lua syntax, any `push` immediatly followed by a `"string expression"`, `{table expression}` or `(paranthesis)` will be interpreted as a function call. Preferably use implicit `push` in these cases.
**Please note** that, in order to stay compatible with vanilla Lua syntax, any `push` immediatly followed by a `"string expression"`, `{table expression}` or `(paranthesis)` will be interpreted as a function call. Preferably use implicit `push` when you can.
##### Implicit `push`
```lua
@ -232,6 +236,22 @@ Values returned by the function will be inserted in the generated table in the o
The table generation function also have access to the `self` (or its alias `@`) variable, which is the table which is being created, so you can set arbitrary fields of the table.
##### One line statements
```lua
if condition()
a()
elseif foo()
b()
if other()
a()
else -- "end" is always needed for else!
c()
end
```
`if`, `elseif`, `for`, and `while` statements can be writtent without `do`, `then` or `end`, in which case they contain a single statement.
### Preprocessor
Before compiling, Candran's preprocessor is run. It execute every line starting with a _#_ (ignoring whitespace) as Candran code.
For example,