Generic Instance Method

append(contentsOf:)

Adds the elements of a sequence or collection to the end of this collection.

Declaration

mutating func append<S>(contentsOf newElements: S) where S : Sequence, Self.Element == S.Element

Parameters

newElements

The elements to append to the collection.

Discussion

The collection being appended to allocates any additional necessary storage to hold the new elements.

The following example appends the elements of a Range<Int> instance to an array of integers:

var numbers = [1, 2, 3, 4, 5]
numbers.append(contentsOf: 10...15)
print(numbers)
// Prints "[1, 2, 3, 4, 5, 10, 11, 12, 13, 14, 15]"

Complexity: O(m), where m is the length of newElements.

See Also

Combining Arrays

func append<S>(contentsOf: S)

Adds the elements of a sequence to the end of the array.

static func + <Other>(Other, Array<Element>) -> Array<Element>

Creates a new collection by concatenating the elements of a sequence and a collection.

static func + <Other>(Array<Element>, Other) -> Array<Element>

Creates a new collection by concatenating the elements of a collection and a sequence.

static func + (Array<Element>, Array<Element>) -> Array<Element>
static func + <Other>(Array<Element>, Other) -> Array<Element>

Creates a new collection by concatenating the elements of two collections.

static func += <Other>(inout Array<Element>, Other)

Appends the elements of a sequence to a range-replaceable collection.

static func += (inout Array<Element>, Array<Element>)