文書   >   Swift   >   Swift 標準ライブラリ   >   Collections   >   Supporting Types   >   PartialRangeFrom   >   split(separator:maxSplits:omittingEmptySubsequences:)     Beta  
インスタンスメソッド
split(separator:maxSplits:
omittingEmptySubsequences:)
与えられた要素に等しい要素の周りで、シーケンスの可能な最長の部分シーケンスを順番に返します。
宣言
func split(separator: Bound, maxSplits: Int = default, omittingEmptySubsequences: Bool = default) -> [AnySequence<Bound>]
パラメータ
separator | 分割すべき要素。 |
maxSplits | シーケンスを分割する最大回数、または返すべき部分シーケンスの数より 1 つ少ない数。maxSplits + 1 個の部分シーケンスが返された場合、最後のシーケンスは、残りの要素を含む元のシーケンスの suffix です。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: " ")
.map(String.init))
// Prints "["BLANCHE:", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"
2 番目の例では、maxSplits パラメータに 1 を渡すため、元の文字列は 1 回だけ分割され、2 つの新しい文字列に分割されます。
print(line.split(separator: " ", maxSplits: 1)
.map(String.init))
// Prints "["BLANCHE:", " I don\'t want realism. I want magic!"]"
最後の例は、omittingEmptySubsequences パラメータに false を渡すため、返される配列には空白が含繰り返す所には空の文字列を含みます。
print(line.split(separator: " ", omittingEmptySubsequences: false)
.map(String.init))
// Prints "["BLANCHE:", "", "", "I", "don\'t", "want", "realism.", "I", "want", "magic!"]"
このドキュメントには、開発中の API または技術に関する予備情報が含まれています。この情報は変更されることがあり、このドキュメントに従って実装されたソフトウェアは、最終的なオペレーティングシステムソフトウェアでテストする必要があります。