wordsBy -package:vector-split

Split into "words", with word boundaries indicated by the given predicate. Satisfies words === wordsBy isSpace; equivalent to split . dropBlanks . dropDelims . whenElt.

>>> wordsBy (`elem` ",;.?! ") "Hello there, world! How?"
["Hello","there","world","How"]

>>> wordsBy (=='x') "dogxxxcatxbirdxx"
["dog","cat","bird"]

A variant of words with a custom test. In particular, adjacent separators are discarded, as are leading or trailing separators.

wordsBy (== ':') "::xyz:abc::123::" == ["xyz","abc","123"]
\s -> wordsBy isSpace s == words s

Chop a list into segments, at separators identified by the predicate. The separator items are discarded.

Like splitOn after stripping leading, trailing, and repeated separators. Therefore, ".a..b." with . as the separator would be parsed as ["a","b"]. In other words, its like parsing words from whitespace separated text.

>>> wordsBy' p xs = Stream.toList $ Stream.wordsBy p Fold.toList (Stream.fromList xs)

>>> wordsBy' (== ',') ""
[]

>>> wordsBy' (== ',') ","
[]

>>> wordsBy' (== ',') ",a,,b,"
["a","b"]

words = wordsBy isSpace

Split the stream after stripping leading, trailing, and repeated separators determined by the predicate supplied. The tokens after splitting are collected by the supplied fold. In other words, the tokens are parsed in the same way as words are parsed from whitespace separated text.

>>> f x = Stream.toList $ Stream.wordsBy (== '.') Fold.toList $ Stream.fromList x

>>> f "a.b"
["a","b"]

>>> f "a..b"
["a","b"]

>>> f ".a..b."
["a","b"]

Split a list into sublists. Generalisation of the prelude function words. Same as wordsBy and wordsBy, but with the non-emptyness guarantee on the chunks. O(n).

words xs == wordsBy isSpace xs

split given list of a by given single a, e.g.

>>> wordsBy (== ':') "bd:3"
["bd", "3"]