Core Functions

Prints a value to standard output without a newline.

print("Hello")
print(" World")  # Output: Hello World

Prints a value to standard output with a newline.

println("Hello World")
println(42)

Reads a line of input from the user. Returns the user's input as a String.

let name = input("Enter your name: ")
println("Hello, " + name)

Returns the type name of a value as a string.

type(42)        # "int"
type("hello")   # "string"
type([1, 2, 3]) # "array"
type(null)      # "null"

Convert a value to a string.

str(42)       # "42"
str(3.14)     # "3.14"
str(true)     # "true"

Convert a value to an integer.

int("42")     # 42
int(3.7)      # 3

Convert a value to a float.

float("3.14") # 3.14
float(42)     # 42.0

Returns the length of a string, array, or hash. Also available as a method: .len, .length, .size are all aliases.

len("hello")      # 5
len([1, 2, 3])    # 3
len({"a": 1})     # 1

# Method syntax (all equivalent)
[1, 2, 3].len     # 3
[1, 2, 3].length  # 3
[1, 2, 3].size    # 3

Add an element to the end of an array.

let arr = [1, 2]
push(arr, 3)     # arr is now [1, 2, 3]

# Or use class method style:
let arr2 = [1, 2]
arr2.push(3)     # arr2 is now [1, 2, 3]

Remove and return the last element from an array.

let arr = [1, 2, 3]
let last = pop(arr)  # last is 3, arr is [1, 2]

# Or use class method style:
let arr2 = [1, 2, 3]
let last2 = arr2.pop  # last2 is 3, arr2 is [1, 2]

Creates an array of numbers from start to end (exclusive).

range(0, 5)      # [0, 1, 2, 3, 4]
range(1, 10, 2)  # [1, 3, 5, 7, 9]
range(5, 0, -1)  # [5, 4, 3, 2, 1]

Remove all elements from an array or all entries from a hash.

let arr = [1, 2, 3]
clear(arr)  # arr is now []

let h = {"a": 1, "b": 2}
h.clear   # h is now {}

Returns an array of all keys in a hash.

let h = {"name": "Alice", "age": 30}
keys(h)       # ["name", "age"]
h.keys      # ["name", "age"]

Returns an array of all values in a hash.

let h = {"name": "Alice", "age": 30}
values(h)     # ["Alice", 30]
h.values    # ["Alice", 30]

Returns an array of [key, value] pairs.

let h = {"name": "Alice", "age": 30}
entries(h)    # [["name", "Alice"], ["age", 30]]
h.entries   # [["name", "Alice"], ["age", 30]]

Check if a key exists in a hash.

has_key({"a": 1}, "a")    # true
has_key({"a": 1}, "b")    # false
let h = {"a": 1}; h.has_key("a")  # true

Merge two hashes together. Values from h2 take precedence.

merge({"x": 1}, {"y": 2})     # {"x": 1, "y": 2}
let h1 = {"a": 1}; let h2 = {"a": 2}; h1.merge(h2)  # {"a": 2}

Create a hash from an array of [key, value] pairs.

from_entries([["a", 1], ["b", 2]])  # {"a": 1, "b": 2}

Split a string by a separator. Returns an array of string parts.

"a,b,c".split(",")      # ["a", "b", "c"]
"hello world".split(" ")  # ["hello", "world"]

Join string parts with a separator.

"a,b,c".join("-")    # "a-b-c"

Check if a string contains a substring.

"hello world".contains("world")  # true
"hello".contains("xyz")          # false

Check if a string starts with a prefix or ends with a suffix.

"hello".starts_with("hell")  # true
"hello".ends_with("llo")     # true

Returns the index of the first occurrence of substring, or -1 if not found.

"hello world".index_of("world")  # 6
"hello".index_of("xyz")          # -1

Extract a substring from start to end (exclusive).

"hello world".substring(0, 5)   # "hello"
"hello world".substring(6, 11)  # "world"

Transform string case and remove whitespace.

"hello".upcase      # "HELLO"
"HELLO".downcase    # "hello"
"  hi  ".trim       # "hi"

Replace all occurrences of a substring.

"hello world".replace("world", "soli")  # "hello soli"

Pad a string to reach the specified width.

"hi".lpad(5)           # "   hi"
"hi".rpad(5)           # "hi   "
"hi".lpad(5, "0")      # "000hi"

Create a String instance from various value types.

String.new(42)       # "42"
String.new(3.14)     # "3.14"
String.new(true)     # "true"

Common math operations.

abs(-5)       # 5
min(3, 7)     # 3
max(3, 7)     # 7

Square root and power functions.

sqrt(16)      # 4.0
pow(2, 3)     # 8.0

Returns the current Unix timestamp as a float with sub-second precision.

let start = clock
# ... do work ...
let elapsed = clock() - start

Read an entire file into a string.

let content = slurp("config.json")

Write content to a file.

barf("output.txt", "Hello, World!")

File Class

Static methods for file operations.

let content = File.read("config.json")

File.write("output.txt", "Hello!")

if File.exists("config.json")

File.delete("old.txt")

let files = File.glob("docs/*.md")

let files = File.glob_recursive("docs/**/*.md")

let lines = File.lines("data.txt")

let time = File.modified("config.json")