Swift UnsafeBufferPointer split(separator:maxSplits:omittingEmptySubsequences:)用法及代碼示例

用法一

實例方法

split(separator:maxSplits:omittingEmptySubsequences:)

按順序返回集合中與給定元素相等的元素周圍的最長可能子序列。

聲明

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

當 Element 符合 Equatable 時可用。

返回值

一個子序列數組，從這個集合的元素中分離出來。

參數

separator: 應該拆分的元素。
maxSplits: 拆分集合的最大次數，或者比要返回的子序列數少一。如果返回maxSplits + 1 子序列，則最後一個是包含剩餘元素的原始集合的後綴。 maxSplits 必須大於或等於零。默認值為 Int.max 。
omittingEmptySubsequences: 如果為 false ，則對於集合中每對連續的 separator 元素以及在集合的開頭或結尾處的每個 separator 實例，將在結果中返回一個空子序列。如果 true ，則僅返回非空子序列。默認值為 true 。

詳述

結果數組最多包含maxSplits + 1 子序列。用於拆分集合的元素不會作為任何子序列的一部分返回。

以下示例顯示了在每個空格字符 (" ") 處拆分字符串時 maxSplits 和 omittingEmptySubsequences 參數的效果。 split 的第一次使用返回最初由一個或多個空格分隔的每個單詞。


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

第二個示例將1 傳遞給maxSplits 參數，因此原始字符串隻被拆分一次，分成兩個新字符串。


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

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

用法二

實例方法

split(separator:maxSplits:omittingEmptySubsequences:)

按順序返回序列中與給定元素相等的元素周圍可能出現的最長子序列。

聲明

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

當 Element 符合 Equatable 時可用。

返回值

一個子序列數組，從這個序列的元素中分離出來。

參數

separator: 應該拆分的元素。
maxSplits: 拆分序列的最大次數，或者比要返回的子序列數少一。如果返回maxSplits + 1 子序列，則最後一個是包含剩餘元素的原始序列的後綴。 maxSplits 必須大於或等於零。默認值為 Int.max 。
omittingEmptySubsequences: 如果 false ，對於序列中每對連續的 separator 元素以及在序列的開頭或結尾處的每個 separator 實例，將在結果中返回一個空子序列。如果 true ，則僅返回非空子序列。默認值為 true 。

詳述

結果數組最多包含maxSplits + 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!"]"

第二個示例將1 傳遞給maxSplits 參數，因此原始字符串隻被拆分一次，分成兩個新字符串。


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

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

相關用法

注：本文由純淨天空篩選整理自apple.com大神的英文原創作品 UnsafeBufferPointer split(separator:maxSplits:omittingEmptySubsequences:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。