文書 > Swift > String > Substring > insert(contentsOf:at:)

汎用インスタンスメソッド

insert(contentsOf:at:)

シーケンスの要素をコレクションの指定された位置に挿入します。

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

newElements	コレクションに挿入すべき新しい要素。
i	新しい要素を挿入すべき位置。index はコレクションの有効なインデックスでなければなりません。

新しい要素は、現在指定されているインデックスにある要素の前に挿入されます。コレクションの endIndex プロパティを index パラメータとして渡すと、新しい要素はコレクションの末尾にに追加されます。

同じ型の配列内に整数の範囲を挿入する例をここに示します。

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]"

このメソッドを呼び出すと、このコレクションで使用する既存の全てのインデックスが無効になることがあります。

複雑さ：O(n + m)、ここで n はこのコレクションの長さであり、m は newElements の長さです。
i == endIndex の場合、このメソッドは append(contentsOf:) と同等です。