58e4d26648
Get rid of the separate opt-in IO class and replace it with a core System class. - Remove wren_io.c, wren_io.h, and io.wren. - Remove the flags that disable it. - Remove the overloads for print() with different arity. (It was an experiment, but I don't think it's that useful.) - Remove IO.read(). That will reappear using libuv in the CLI at some point. - Remove IO.time. Doesn't seem to have been used. - Update all of the tests, docs, etc. I'm sorry for all the breakage this causes, but I think "System" is a better name for this class (it makes it natural to add things like "System.gc()") and frees up "IO" for referring to the CLI's IO module.
2.5 KiB
^title List Class ^category core
Extends Sequence.
An indexable contiguous collection of elements. More details here.
Methods
add(item)
Appends item to the end of the list.
clear()
Removes all elements from the list.
count
The number of elements in the list.
insert(index, item)
Inserts the item at index in the list.
:::dart
var list = ["a", "b", "c", "d"]
list.insert(1, "e")
System.print(list) // "[a, e, b, c, d]".
The index may be one past the last index in the list to append an element.
:::dart
var list = ["a", "b", "c"]
list.insert(3, "d")
System.print(list) // "[a, b, c, d]".
If index is negative, it counts backwards from the end of the list. It bases this on the length of the list after inserted the element, so that -1 will append the element, not insert it before the last element.
:::dart
var list = ["a", "b"]
list.insert(-1, "d")
list.insert(-2, "c")
System.print(list) // "[a, b, c, d]".
Returns the inserted item.
:::dart
System.print(["a", "c"].insert(1, "b")) // "b".
It is a runtime error if the index is not an integer or is out of bounds.
iterate(iterator), iteratorValue(iterator)
Implements the iterator protocol for iterating over the elements in the list.
removeAt(index)
Removes the element at index. If index is negative, it counts backwards
from the end of the list where -1 is the last element. All trailing elements
are shifted up to fill in where the removed element was.
:::dart
var list = ["a", "b", "c", "d"]
list.removeAt(1)
System.print(list) // "[a, c, d]".
Returns the removed item.
System.print(["a", "b", "c"].removeAt(1)) // "b".
It is a runtime error if the index is not an integer or is out of bounds.
[index] operator
Gets the element at index. If index is negative, it counts backwards from
the end of the list where -1 is the last element.
:::dart
var list = ["a", "b", "c"]
System.print(list[1]) // "b".
It is a runtime error if the index is not an integer or is out of bounds.
[index]=(item) operator
Replaces the element at index with item. If index is negative, it counts
backwards from the end of the list where -1 is the last element.
:::dart
var list = ["a", "b", "c"]
list[1] = "new"
System.print(list) // "[a, new, c]".
It is a runtime error if the index is not an integer or is out of bounds.