The new element to insert into the collection. コレクションに挿入されることになる新しい要素。
Instance Method
インスタンスメソッド
insert(_:
insert(_:at:)
Inserts a new element 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 10.0+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
Available when
Base conforms to RangeReplaceableCollection .
BaseがRangeReplaceableCollection に準拠する時に利用可能です。
Parameters パラメータ
newElementiThe position at which to insert the new element.
indexmust be a valid index into the collection. そこで新しい要素が挿入されることになる位置。indexはコレクションに対する有効なインデックスでなければなりません。
Discussion 解説
The new element is inserted before the element currently at the specified index. If you pass the collection’s end property as the index parameter, the new element is appended to the collection.
新しい要素は、指定されたインデックスでの現在の要素の前に挿入されます。あなたがコレクションのendプロパティをindexパラメータとして渡すならば、新しい要素がコレクションに追加されます。
var numbers = [1, 2, 3, 4, 5]
numbers.insert(100, at: 3)
numbers.insert(200, at: numbers.endIndex)
print(numbers)
// Prints "[1, 2, 3, 100, 4, 5, 200]"Calling this method may invalidate any existing indices for use with this collection. このメソッドを呼び出すことは、このコレクションで使うためのあらゆる既存のインデックスを無効にします。
Complexity: O(n), where n is the length of the collection. If i == end, this method is equivalent to append(_:).
計算量：O(n)、ここでnはコレクションの長さです。i == endならば、このメソッドはappend(_:)に相当します。