文書 > Swift > Array > split(separator:maxSplits:omittingEmptySubsequences:)

インスタンスメソッド

split(separator:maxSplits:omittingEmptySubsequences:)

与えられた要素と等しい要素を中心にして、コレクションの可能な限り長い部分シーケンスを順番に返します。

宣言

func split(separator: Element, maxSplits: Int = Int.max, omittingEmptySubsequences: Bool = true) -> [ArraySlice<Element>]

Element が Equatable に準拠している場合に使用できます。

パラメータ

separator	分割されるべき要素。
maxSplits	コレクションを分割すべき最大回数、または返す部分シーケンスの数より 1 少ない数。maxSplits + 1 個の部分シーケンスが返された場合、最後のものは残りの要素を含む元のコレクションの接尾辞です。maxSplits はゼロ以上でなければなりません。デフォルト値は Int.max です。
omittingEmptySubsequences	false の場合、コレクション内の separator 要素の連続したペアごと、およびコレクションの先頭または末尾の separator のインスタンスごとに、空の部分シーケンスが結果に返されます。true の場合、空でない部分シーケンスのみが返されます。デフォルト値は true です。

戻り値

このコレクションの要素から分割された部分シーケンスの配列。

議論

結果の配列は、最大で maxSplits + 1 個の部分シーケンスで構成されます。コレクションを分割するために使用される要素は、どの部分シーケンスの一部としても返されません。

以下の例は、各空白文字(" ") で文字列を分割するときの maxSplits パラメータと omittingEmptySubsequences パラメータの効果を示しています。split を最初に使用すると、もともと 1 つ以上の空白で区切られていた各単語が返されます。

let line = "BLANCHE:   I don't want realism. I want magic!"
print(line.split(separator: " "))
// Prints "["BLANCHE:", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"

2 番目の例では、maxSplits パラメータに 1 を渡しているため、元の文字列は 1 回だけ分割され、2 つの新しい文字列になります。

print(line.split(separator: " ", maxSplits: 1))
// Prints "["BLANCHE:", "  I don\'t want realism. I want magic!"]"

最後の例では、omittingEmptySubsequences パラメータに false を渡しているため、返される配列は、空白が繰り返された場所で空の文字列が含まれるものになります。

print(line.split(separator: " ", omittingEmptySubsequences: false))
// Prints "["BLANCHE:", "", "", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"

複雑さ：O(n)、ここで n はコレクションの長さです。