Skip to main content
Version: Next

Array

a = [1, 2, 3, 4, 5]
puts(a[2])
puts(a[-2])
puts(a[:2])
puts(a[:-2])
puts(a[2:])
puts(a[-2:])
puts(a[1:-2])

// should output
[1, 2]
[1, 2, 3]
[3, 4, 5]
[4, 5]
[2, 3]
[1, 2, 8, 9, 5]

Literal Specific Methods​

first()​

Returns STRING|ARRAY|HASH|BOOLEAN|INTEGER|NIL|FUNCTION|FILE

Returns the first element of the array. Shorthand for array[0]

["a", "b", 1, 2].first()
Output
"a"

include?(STRING|ARRAY|HASH|BOOLEAN|INTEGER|NIL|FILE)​

Returns BOOLEAN

Returns true or false wether the array contains the given element

[1,2,3].include?(4)
[1,2,3].include?(3)
Output
false
true

index(STRING|ARRAY|HASH|BOOLEAN|INTEGER|NIL|FILE)​

Returns INTEGER

Returns the index of the given element in the array if found. Otherwise return -1.

["a", "b", 1, 2].index(1)
Output
2

join(STRING)​

Returns STRING

last()​

Returns STRING|ARRAY|HASH|BOOLEAN|INTEGER|NIL|FUNCTION|FILE

Returns the last element of the array.

["a", "b", 1, 2].last()
Output
2

reverse()​

Returns ARRAY

Reverses the elements of the array

["a", "b", 1, 2].reverse()
Output
[2, 1, "b", "a"]

size()​

Returns INTEGER

Returns the amount of elements in the array.

["a", "b", 1, 2].size()
Output
4

slices(INTEGER)​

Returns ARRAY

Returns the elements of the array in slices with the size of the given integer

[1,2,3,4,5,6,7,8].slices(3)
Output
[[1, 2, 3], [4, 5, 6], [7, 8]]

sort()​

Returns ARRAY

Sorts the array if it contains only one type of STRING, INTEGER or FLOAT

[3.4, 3.1, 2.0].sort()
Output
[2.0, 3.1, 3.4]

sum()​

Returns INTEGER

uniq()​

Returns ARRAY|ERROR

Returns a copy of the array with deduplicated elements. Raises an error if a element is not hashable.

["a", 1, 1, 2].uniq()
Output
[1, 2, "a"]

pop()​

Returns STRING|ARRAY|HASH|BOOLEAN|INTEGER|NIL|FUNCTION|FILE

Removes the last element of the array and returns it.

a = [1,2,3]
a.pop()
a
Output
[1, 2, 3]
3
[1, 2]

push(STRING|ARRAY|HASH|BOOLEAN|INTEGER|NIL|FUNCTION|FILE)​

Returns NIL

Adds the given object as last element to the array.

a = [1,2,3]
a.push("a")
a
Output
[1, 2, 3]
nil
[1, 2, 3, "a"]

Generic Literal Methods​

methods()​

Returns ARRAY

Returns an array of all supported methods names.

"test".methods()
Output
["upcase", "find", "format", "reverse", "split", "replace", "strip!", "count", "reverse!", "lines", "downcase!", "upcase!", "size", "strip", "downcase"]

to_f()​

Returns FLOAT

If possible converts an object to its float representation. If not 0.0 is returned.

1.to_f()
"1.4".to_f()
nil.to_f()
Output
1.0
1.4
0.0

to_i(INTEGER)​

Returns INTEGER

If possible converts an object to its integer representation. If not 0 is returned.

true.to_i()
false.to_i()
1234.to_i()
"4".to_i()
"10011010010"to_i(2)
"2322".to_i(8)
"0x2322".to_i()
Output
1
0
1234
4
1234
1234
1234

to_json()​

Returns STRING|ERROR

Returns the object as json notation.

a = {"test": 1234}
a.to_json()
Output
{"test": 1234}
"{\"test\":1234}"

to_s(INTEGER)​

Returns STRING

If possible converts an object to its string representation. If not empty string is returned.

true.to_s()
1234.to_s()
1234.to_s(2)
1234.to_s(8)
1234.to_s(10)
"test".to_s()
1.4.to_s()
Output
"true"
"1234"
"10011010010"
"2322"
"1234"
"test"
"1.4"

type()​

Returns STRING

Returns the type of the object.

"test".type()
Output
"STRING"

wat()​

Returns STRING

Returns the supported methods with usage information.

true.wat()
Output
"BOOLEAN supports the following methods: to_s()"