Swift CollectionDifference 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大神的英文原创作品 CollectionDifference split(separator:maxSplits:omittingEmptySubsequences:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。