Special Functions ​

call ​

cd ​

The current directory can be changed using the built-in cd command, just like with other shells. The $PWD environment variable can be accessed to get the path to the current directory. Further more, cd - changes to the previous directory.

cd directory
echo($PWD)
cd ..

cd directory
echo($PWD)
cd ..

exec ​

Described in program-invocation#exec.

scriptPath ​

The path of the folder containing the currently executed script can be retrieved by calling the scriptPath function.

assert(scriptPath() == "/home/user/scripts")

assert(scriptPath() == "/home/user/scripts")

time ​

The time function measures how long it takes for the argument to evaluate, similar to the behaviour in other shells. However, you need to pass it as a proper function argument rather than a text argument.

time(sleep 3)
# or
sleep 3 | time

time(sleep 3)
# or
sleep 3 | time

__onExit (user-defined) ​

If an __onExit function is defined in a script, it will be called automatically before the program exits.

echo hi

fn __onExit() {
    echo bye
}

echo hi

fn __onExit() {
    echo bye
}