split method Null safety
- Characters pattern,
- [int maxParts = 0]
Splits the current range of characters at each occurrence of pattern
.
Returns a lazy iterable of character ranges that were separated by
pattern
.
Each provided character range object is new
and unrelated to this character range
The iterable has at most maxParts
elements if a positive maxParts
is supplied.
Finds each occurrence of pattern
in the range, which does not overlap
with a previously found occurrence, then the non-matched characters
of the range before, after and between the matches are provided
in first-to-last position order.
If pattern
is empty, the range is split into separate characters,
and no leading or trailing empty ranges are provided unless the
range itself is empty, in which case a single empty range is the
only result range.
Otherwise a range starting or ending with pattern
will cause
an empty range to be emitted at the start or end.
If maxParts
is provided and greater than zero,
only the first maxParts - 1
occurrences of pattern
are found
and split at.
Any further occurrences will be included in the last part.
Example:
var c = "abracadabra".characters.dropFirst().dropLast();
// c is "bracadabr".
var parts = c.split("a".characters, 3).toList();
print(parts); // [br, c, dabr]
If there are fewer than maxParts - 1
occurrences of pattern
,
then the characters are split at all occurrences.
If maxParts
is zero or negative, it is ignored and the result
is split at all occurrences of pattern
.
Implementation
Iterable<CharacterRange> split(Characters pattern, [int maxParts = 0]);