split method Null safety

Iterable<CharacterRange> split(
  1. Characters pattern,
  2. [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]);