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

Appending Strings and Characters

func append(String)

Appends the given string to this string.

func append(Character)

Appends the given character to the string.

func append(contentsOf: String)

func append(contentsOf: Substring)

func append<S>(contentsOf: S)

Appends the characters in the given sequence to the string.

func reserveCapacity(Int)

Reserves enough space in the string’s underlying storage to store the specified number of ASCII characters.

static func + (String, String) -> String

static func += (inout String, String)

static func + <Other>(Other, String) -> String

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

static func + <Other>(String, Other) -> String

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

static func + <Other>(String, Other) -> String

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

static func += <Other>(inout String, Other)

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