Inserts the elements of a sequence into the collection at the specified position.
Required. Default implementation provided.
SDK
- Xcode 8.3+
Framework
- Swift Standard Library
Declaration
mutating func insert<S>(contentsOf newElements: S, at i: Self.Index) where S : Collection, Self.Element == S.Element
Parameters
newElementsThe new elements to insert into the collection.
iThe position at which to insert the new elements.
indexmust be a valid index of the collection.
Discussion
The new elements are inserted before the element currently at the specified index. If you pass the collection’s end 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)
print(numbers)
// 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 new. If i == end, this method is equivalent to append(contents.