Append( list1, list2 )
Append adds (see Add) the elements of the list list2 to the end of
the list list1. list2 may contain holes, in which case the
corresponding entries in list1 will be left unbound.
nothing, it is called only for its side effect.
gap> l := [ 2, 3, 5 ];; Append( l, [ 7, 11, 13 ] ); l; [ 2, 3, 5, 7, 11, 13 ] gap> Append( l, [ 17,, 23 ] ); l; [ 2, 3, 5, 7, 11, 13, 17,, 23 ]
Note that appending to a list changes the list. The ability to change an object is only available for lists and records (see Identical Lists).
Append changes the first argument, while
Concatenation) creates a new list and leaves its arguments unchanged.
As usual the name of the function that work destructively is a verb, but
the name of the function that creates a new object is a substantive.
Previous Up Top Next