split abstract method

Iterable<Characters> split(
  1. Characters pattern, [
  2. int maxParts = 0
])

Splits this sequence of characters at each occurrence of pattern.

Returns a lazy iterable of characters that were separated by pattern. The iterable has at most maxParts elements if a positive maxParts is supplied.

Finds each occurrence of pattern, which does not overlap with a previously found occurrence, then the non-matched characters before, after, and between the matches are provided in first-to-last position order. If pattern is empty, the character sequence 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 character sequence 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;
var parts = c.split("a".characters, 4).toList();
print(parts); // Prints is ["", "br", "c", "dabra"]

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

/// If [pattern] is empty, the character sequence 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 character sequence 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:
/// ```dart
/// var c = "abracadabra".characters;
/// var parts = c.split("a".characters, 4).toList();
/// print(parts); // Prints is ["", "br", "c", "dabra"]
/// ```
/// 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].
Iterable<Characters> split(Characters pattern, [int maxParts = 0]);