/list proc

Adds a value, or multiple values, to the list.

var/list/L = list(1, 2)

L.Add(3)
world.log << json_encode(L) // "[1,2,3]"

L.Add(4, 5)
world.log << json_encode(L) // "[1,2,3,4,5]"

If any of the values are another list then the contents of that list will be added rather than the list itself.

var/list/L1 = list(1, 2)
var/list/L2 = list(3, 4)

L1.Add(L2)

// "[1,2,3,4]"
// NOT "[1,2,[3,4]]"
world.log << json_encode(L1)

Returns a new shallow copy of the list.

var/list/L1 = list(1, 2, 3)
var/list/L2 = L1.Copy(2)

world.log << json_encode(L2) // "[2,3]"

Removes the indicated elements from the list.

var/list/L = list(1, 2, 3, 4)
L.Cut(2, 4)

world.log << json_encode(L) // "[1,4]"

Search for the given item in the list. If any values in the list are equal, this will return its index. Otherwise it will return 0.

var/list/L = list(10, 20, 30, 20)

// Will return the first instance of 20
world.log << L.Find(20) // 2