Home /Modules/api/LANGUAGE-API.md

LANGUAGE-API.md

api/sleela/3.1/LANGUAGE-API.md · 54 line(s) · markdown

SLeeLa 3.1 language API

Normative text: SLEELA.syntax sections 44 (literal, initializer, labels, finally), 45 (the char specification) and 46 (the array specification). This page is the quick reference; where it and the specification differ, the specification wins. Every form below needs #sleela 3.1 (or 3.01); under an older declaration it is the error <form> requires #sleela 3.1.

Character

FormMeaning
'a', '\n', '\u0041', '\'', 'é'a character literal; its value is the UTF-16 code unit and its static type is char
char c = 65;a char holds 0 to 65535; a store keeps the low 16 bits (char c = 65601; is 65)
c + 1, -c, ~c, c * 2arithmetic on a char gives an int
c++, c += 2stay char and wrap at 16 bits
(char) nnarrows to 16 bits; (char) -1 is 65535
"x" + c, s += c, print(c)a value of static type char is shown as the character, not its number
SLChar.toString(c)the one-character text, usable where the static type is lost (Any, an int parameter)

A character outside the basic multilingual plane is a lexical error (it is two code units). Library: lib/char/SLChar.sleela (classification, case, digits, surrogates, toCodePoint, compare).

Arrays

FormMeaning
int[] a = {3, 1, 2}; static int[] p = {2, 3};array initializer (local or field); {} and a trailing comma are allowed
new int[]{4, 5, 6}an array expression
new int[3][4], new int[2][3][4]rectangular creation, any rank up to 8 sized dimensions
new int[3][]a jagged array: three rows, each null until assigned
new int[][]{{1, 2}, {3}}nested initializer
a.lengththe number of elements; read-only (a.length = 5 and a.length++ are errors); arrayLength(a) is the same
a[i]the index is checked on every access; out of range is a runtime error (catchable inside a try, SLEELA.syntax 37.5)

new T[n] fills with 0, 0.0, false or null by element type. An array is a reference: assignment and argument passing share it. Limits: 4096 live arrays (each row of a grid is one), 2^25 elements per array, 32 bytes per element. Library: lib/array/ — SLIntArray, SLDoubleArray, SLRefArray, SLArray2D (copy, fill, sort, search, sum, transpose, text).

Labeled statements and abrupt completion

FormMeaning
outer: for (...) { ... }label a loop, a switch or a block
break outer; / continue outer;leave the labeled statement / start the next iteration of the labeled loop
return, break, continue inside try/catch with a finallythe finally runs before the jump (a return inside the finally replaces the value)
continue inside a switch in a loopcontinues the loop

An undefined label is break to undefined label 'x'.

Version

#sleela 3.01 and #sleela 3.1 name the same edition. The supported range is 1.0 to 3.1; #sleela 3.2 is a future edition and is rejected.