docs: document removeAt() return value and update list examples

2015-02-22 18:26:31 +00:00
parent ad7318d101
commit 9016d6e12d
2 changed files with 10 additions and 2 deletions
@@ -95,9 +95,13 @@ given position in the list. All following items are shifted up to fill in the
 gap:

    :::dart
-    var letters = ["a", "b", "c"]
+    var letters = ["a", "b", "c", "d"]
    letters.removeAt(1)
-    IO.print(letters) // ["a", "c"]
+    IO.print(letters) // ["a", "c", "d"]
+
+The `removeAt` method returns the removed item:
+
+    IO.print(letters.removeAt(1)) // "c"

 If you want to remove everything from the list, you can clear it: