27.8 Append

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. Append returns 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).

Note that Append changes the first argument, while Concatenation (see 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
Index