Functions Documentation
View Function Edit Function
Name append
Syntax (append a b [...]) -> concatenated list
Argument List a: A list, string, integer, boolean or literal you want to start the new list.
b: A list, string, integer, boolean or literal you want to append on to the previous argument.
[...]: Optional list, string, integer, boolean or literal. Can be repeated.
Returns list: A new list containing all the elements of the passed in arguments with their order preserved.
Category list
Description Makes a new list with all the elements of the passed in arguments in the order that they came in at.
At least two arguments must be provided.
If the first argument is not a list, an empty list with that argument as first element will be created, and the rest of the arguments will be appended to that list
Example
(append '(a b c) '(d e))
Will return the list (a b c d e)
(append '(a) '(d) '(b e))

Will return the list (a d b e)
Comment It is important to note, that if one of the arguments is a list, then the *elements* of that list will be appended one by one, and *not* the list itself. As an example
(append "a" '(b c)) -> (a b c) not (a (b c))

But any list *inside* a list will be preserved. Example:
It is important to note, that if one of the arguments is a list, then the *elements* of that list will be appended one by one, and *not* the list itself. As an example
(append "a" '(b '(c d))) -> (a b (c d))