Modules

Using module

To use a module, we have a use statement.

use math

The above statement will load the math module. By default, this module return a map that contains its functions and properties.

puts math.abs(-20)    // 20

Like variable declaration, we can use multiple modules at one statement.

use math, io, task

Alias

Using module with another name, or many module have special name, alias is a great way to deal with them.

use m as 'math'
use my_math as 'this-is-my-custom-math'

Creating module

Createa new file: my_num.no

my_num.no

return 100

Use it in your code:

main.no

use my_num
puts my_num    // 100

my_num.no returns a number, so my_num is a number, 100.

Of course, a function or any value works fine.

my_add.no

func add(a, b) {
    return a + b
}

return add

main.no

use my_add
puts my_add(3, 4)    // 7

A module can be used multiple times, but its code executes only once, on the first load.

You should declare using of modules in top of your code.

Notes

The variable is declared in use statement is immutable, so you cannot modify it.

use math
    math = 20
//  ^^^^-- This variable is immutable.

If a module is not found, you will get a runtime error.

use 'abc'
//   ^^^-- Could not find this module.