Generic Instance Method


Inserts the elements of a sequence into the collection at the specified position.


mutating func insert<C>(contentsOf newElements: C, at i: Int) where C : Collection, Self.Element == C.Element



The new elements to insert into the collection.


The position at which to insert the new elements. index must be a valid index of the collection.


The new elements are inserted before the element currently at the specified index. If you pass the collection’s endIndex property as the index parameter, the new elements are appended to the collection.

Here’s an example of inserting a range of integers into an array of the same type:

var numbers = [1, 2, 3, 4, 5]
numbers.insert(contentsOf: 100...103, at: 3)
// Prints "[1, 2, 3, 100, 101, 102, 103, 4, 5]"

Calling this method may invalidate any existing indices for use with this collection.

Complexity: O(n + m), where n is length of this collection and m is the length of newElements. If i == endIndex, this method is equivalent to append(contentsOf:).

See Also

Adding Elements

func append(Element)

Adds a new element at the end of the array.

func insert(Element, at: Int)

Inserts a new element at the specified position.

func replaceSubrange<C>(Range<Int>, with: C)

Replaces a range of elements with the elements in the specified collection.

func replaceSubrange<C, R>(R, with: C)

Replaces the specified subrange of elements with the given collection.

func reserveCapacity(Int)

Reserves enough space to store the specified number of elements.