Release calc version 2.10.2t30

help/append

@@ -0,0 +1,60 @@
+NAME
+    append - append one or more values to end of list
+
+SYNOPSIS
+    append(x, y_0, y_1, ...)
+
+TYPES
+    x		lvalue whose value is a list
+    y_0, ...	any
+
+    return	null value
+
+DESCRIPTION
+    If after evaluation of y_0, y_1, ..., x is a list with contents
+    (x_0, x_1, ...), then after append(x, y_0, y_1, ...), x has
+    contents (x_0, x_1, ..., y_0, y_1, ...).
+
+    If after evaluation of y_0, y_1, ..., x has size n,
+    append(x, y_0, y_1, ...) is equivalent to insert(x, n, y_0, y_1, ...).
+
+EXAMPLE
+    > x = list(2,3,4)
+    > append(x, 5, 6)
+    > print x
+
+    list (5 elements, 5 nonzero):
+      [[0]] = 2
+      [[1]] = 3
+      [[2]] = 4
+      [[3]] = 5
+      [[4]] = 6
+
+    > append(x, pop(x), pop(x))
+    > print x
+
+    list (5 elements, 5 nonzero):
+      [[0]] = 4
+      [[1]] = 5
+      [[2]] = 6
+      [[3]] = 2
+      [[4]] = 3
+
+    > append(x, (remove(x), 7))
+    > print x
+
+    list (5 elements, 5 nonzero):
+      [[0]] = 4
+      [[1]] = 5
+      [[2]] = 6
+      [[3]] = 2
+      [[4]] = 7
+
+LIMITS
+    append() can have at most 100 arguments
+
+LIBRARY
+    none
+
+SEE ALSO
+     delete, insert, islist, list, pop, push, remove, rsearch, search, size