Array

Array for storing multiple values in a single variable.

Syntax

To initialize an array, use the [] operator (It more like Go).

let items = [number] { 1, 2, 3 };

items.sum();
// 6

items.len();
// 3

Init array

And you can also to define multiple types of arrays.

// a number array
let number_items = [number] { 1, 2, 3 };

// a string array
let string_items = [string] { "hello", "world" };

// a struct array
struct Item {
  name: string
}

let struct_items = []Item{
    Item { a: 1, b: "hello" },
    Item { a: 2, b: "world" },
};

// a color array
let color_items = [color] { #ff0000, #00ff00, #purple };

Methods

len

Get the length of the array.

let items = [number] { 1, 2, 3 };
items.len();
// 3

iter

Iterate the array.

let items = [number]{ 1, 2, 3 };
items.iter((item) => {
    item.to_string();
});

slice

Get a slice (Same like JavaScript) of the array.

let items = [number] { 1, 2, 3, 4, 5 };
items.slice(1, 3);
// [2, 3]

clear

Remove all items from the array.

let items = [number] { 1, 2, 3 };
items.clear();
// 0

reverse

Reverse the array.

let items = [number] { 1, 2, 3 };
items.reverse();
// [3, 2, 1]

let str_items = [string] { "a", "b", "c" };
str_items.reverse();
// ["c", "b", "a"]

push

Push an item to the end of the array.

let items = []number{1, 2, 3};
items.push(4);
items;
// [1, 2, 3, 4]

pop

Pop an item from the end of the array.

let items = [number]{ 1, 2, 3 };
items.pop();
// 3
items;
// [1, 2]

shift

Insert an item to the beginning of the array.

let items = [number] { 1, 2, 3 };
items.shift(0);
items;
// [0, 1, 2, 3]

unshift

Remove an item from the beginning of the array.

let items = [number]{ 1, 2, 3 };
items.unshift();
// 1
items;
// [2, 3]

remove

Remove an item from the array, and return the removed item.

let items = [string] { "a", "b", "c" };
items.remove(1);
// "a"
items;
// ["b", "c"]

get

Get an item at the given index.

let items = [string] { "a", "b", "c" };
items.get(1);
// "b"

set

Set an item in the array.

let items = [string] { "a", "b", "c" };
items.set(1, "d");
items;
// ["a", "d", "c"]

iter

Create a Iterator for the array.

let items = [number] { 1, 2, 3 };
let iter = items.iter();
iter.next();
// 1

clone

Returns a copy of the array.

let items = []number{ 1, 2, 3 };

let items1 = items.clone();
// items1 is [1, 2, 3]

items.clear()
// items is [], items1 still is [1, 2, 3]

Methods for [number]

sum

Get the sum of the array.

let items = [number] { 1, 2, 3 };
items.sum();
// 6

avg

Get the average of the array.

let items = [number] { 1, 2, 3 };
items.avg();
// 2

min

Get the minimum value of the array.

let items = [number] { 1, 2, 3 };
items.min();
// 1

max

Get the maximum value of the array.

let items = [number] { 1, 2, 3 };
items.max();
// 3

avg

Get the average of the array.

let items = [number] { 23, 5, 28 };
items.avg();
// 18.666666666666668

sort

Sort the array.

let items = [number] { 2, 4, 3, 1 };
items.sort();
// items is [1, 2, 3, 4]

Methods for [string]

join

Join the array with the given separator.

let items = [string] { "hello", "world" };
let a1 = items.join(" ");
// a1 is "hello world"

let items1 = "hello world".split(" ").join(",");
// items1 is "hello,world"