jsonpiler 0.11.0

a Json syntax programming language for Windows
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

# Control flow

## define

```jspl
define(
  name: Ident,
  params: TypeAnnotations,
  return_type: Ident,
  body: Any
) -> "Null"
```

Registers a user-defined function with the following parameters:

- name: the function name.
- params: the parameter type.
- return_type: the return type.
- body: the function body.

The `define` keyword introduces a new scope.

```jspl
define(by_two, { n: Int }, Int, n + n)
by_two(2) => 4
```

**Types not allowed as arguments or return values**:

- `Array`
- `Object`

## if

```jspl
if([Bool, Any]...) -> Any
if(Bool, Any) -> Any
```

Evaluates each condition in order.
If a condition is `true`,
the corresponding `then` expression is evaluated and its value is returned.
All branches must return the same type.
If no condition is `true`, an error is occurred.
If every branch returns `Null`, the final `[true, ...]` branch may be omitted.

```jspl
if(
  [1 == 1, message("1 == 1✨", "`then` branch.")],
  [1 == 2, message("1 == 2🤔", "`else if` branch.")],
  [true, message("1 == ?🤣", "`else` branch.")]
)
  => null
```

## while

```jspl
while(Bool, Block) -> Null
```

Evaluates the `body` repeatedly while the `condition` is `true`.
Returns `null`.

```jspl
let(i) = 0
while(i < 5,
{
  message("Loop", "");
  i += 1
}
)
```

## import

```jspl
import(path: Str (Literal), functions: Ident, ...) -> Null
```

Evaluates the specified file at startup and adds the specified function to the namespace.
The path is relative to the current file.
Does not affect existing variables.
If the same file is imported more than once, no new code is generated, and functions are reused.
Importing a function with the same name from a different file causes a redefinition error.
An error occurs if the specified function is not found in the file or not exported.

```jspl
import("my_library.jspl", my_func)
my_func()
```

## export

```jspl
export(Ident, ...) -> Null
```

Exports the specified functions for import by other files.
An error occurs if a specified function is not defined in the current file.

## ret

```jspl
ret(Any) -> Null
```

Terminates the function and returns the given value.
`ret` may only be used within a function defined by `define`.

## break

```jspl
break() -> Null
```

Terminates the innermost `while` loop.
`break` may only be used within a `while` loop.

## continue

```jspl
continue() -> Null
```

Terminates the current iteration of the innermost `while` loop.
`continue` may only be used within a `while` loop.