The new elements to insert into the collection. コレクションへ挿入される新しいいくらかの要素。
Generic Instance Method
総称体インスタンスメソッド
insert(contents
insert(contentsOf:at:)
Inserts the elements of a sequence into the collection at the specified position.
あるシーケンスに属する複数の要素をコレクションへ指定された位置で挿入します。
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 9.3+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
mutating func insert<S>(contentsOf newElements: S, at i: Slice<Base>.Index) where S : Collection, Base.Element == S.ElementAvailable when
Base conforms to RangeReplaceableCollection .
BaseがRangeReplaceableCollection に準拠する時に利用可能です。
Parameters パラメータ
newElementsiThe position at which to insert the new elements.
indexmust be a valid index of the collection. そこで新しいいくらかの要素が挿入されるところの位置。indexはコレクションの有効なインデックスでなければなりません。
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.
新しいいくらかの要素が、指定されたインデックスでの現在の要素の前に挿入されます。あなたがコレクションのendプロパティをindexパラメータとして渡すならば、いくらかの新しい要素がコレクションに追加されます。
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.
計算量：O(n + m)、ここでnは配列の長さです、そしてmはnewの長さです。i == endならば、このメソッドはappend(contentsに相当します。