docs; list; add + operator documentation

This commit is contained in:
underscorediscovery
2019-02-05 18:18:38 -08:00
parent 21024bfa13
commit 7cc7c715c9
2 changed files with 21 additions and 0 deletions

View File

@ -89,6 +89,16 @@ back. Doing so counts back from the size of the list *after* it's grown by one:
letters.insert(-2, "e") // Counts back from size after insert.
System.print(letters) //> [a, b, c, e, d]
## Adding lists together
Lists have the ability to be added together via the `+` operator. This is often known as concatenation.
:::wren
var letters = ["a", "b", "c"]
var other = ["d", "e", "f"]
var combined = letters + other
System.print(combined) //> [a, b, c, d, e, f]
## Removing elements
The opposite of `insert` is `removeAt`. It removes a single element from a
@ -111,5 +121,6 @@ If you want to remove everything from the list, you can clear it:
hirsute.clear()
System.print(hirsute) //> []
<br><hr>
<a class="right" href="maps.html">Maps &rarr;</a>
<a href="values.html">&larr; Values</a>

View File

@ -110,3 +110,13 @@ backwards from the end of the list where `-1` is the last element.
System.print(list) //> [a, new, c]
It is a runtime error if the index is not an integer or is out of bounds.
## **+**(other) operator
Appends a list to the end of the list (concatenation). `other` must be a `List`.
:::wren
var letters = ["a", "b", "c"]
var other = ["d", "e", "f"]
var combined = letters + other
System.print(combined) //> [a, b, c, d, e, f]