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.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software