CharacterRange class abstract
A range of characters of a Characters.
A range of consecutive characters in source, corresponding to a start and end position in the source sequence. The range may even be empty, but that will still correspond to a position where both start and end happen to be the same position.
The source sequence can be separated into the preceding characters, those before the range, the range itself, and the following characters, those after the range.
Some operations inspect or act on the characters of the current range, and other operations modify the range by moving the start and/or end position.
In general, an operation with a name starting with move will move
both start and end positions, selecting an entirely new range
which does not overlap the current range.
Operations starting with collapse reduces the current range to
a sub-range of itself.
Operations starting with expand increase the current range
by moving the end position to a later position
or the start position to an earlier position,
and operations starting with drop reduce the current range
by moving the start to a later position or the end to an earlier position,
thereby dropping characters from one or both ends from the current range.
The character range implements Iterator The moveNext operation, when called with no argument, iterates the next single characters of the source sequence.
Constructors
- CharacterRange.new(String string)
-
Creates a new character iterator iterating the character
of
string.factory - CharacterRange.at(String string, int startIndex, [int? endIndex])
-
Creates a new character iterator on
string.factory
Properties
- charactersAfter → Characters
-
The characters after the current range.
no setter
- charactersBefore → Characters
-
The characters before the current range.
no setter
- current → String
-
The current element.
no setterinherited
- currentCharacters → Characters
-
The characters of this range.
no setter
- hashCode → int
-
The hash code for this object.
no setterinherited
- isEmpty → bool
-
Whether the current range is empty.
no setter
- isNotEmpty → bool
-
Whether the current range is not empty.
no setter
- runes → Runes
-
The code points of the current character range.
no setter
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- source → Characters
-
The character sequence that this range is a sub-sequence of.
no setter
- stringAfter → String
-
The string of the characters after the current range.
no setter
- stringAfterLength → int
-
The length, in code units, of stringAfter.
no setter
- stringBefore → String
-
The string of the characters before the current range.
no setter
- stringBeforeLength → int
-
The length, in code units, of stringBefore.
no setter
-
utf16CodeUnits
→ Iterable<
int> -
The code units of the current character range.
no setter
Methods
-
collapseToEnd(
) → void - Collapses the range to its end.
-
collapseToFirst(
Characters target) → bool -
Collapses to the first occurrence of
targetin the current range. -
collapseToLast(
Characters target) → bool -
Collapses to the last occurrence of
targetin the current range. -
collapseToStart(
) → void - Collapses the range to its start.
-
copy(
) → CharacterRange - Creates a copy of this CharacterRange.
-
dropBackTo(
Characters target) → bool -
Drops the last occurrence of
targetin the range. -
dropBackUntil(
Characters target) → bool -
Drops characters from the end of the range until after
the last occurrence of
target. -
dropBackWhile(
bool test(String)) → void -
Drops characters from the end of the range while they satisfy
test. -
dropFirst(
[int count = 1]) → bool -
Drop the first
countcharacters from the range. -
dropLast(
[int count = 1]) → bool -
Drop the last
countcharacters from the range. -
dropTo(
Characters target) → bool -
Drops the first occurrence of
targetin the range. -
dropUntil(
Characters target) → bool -
Drops characters from the start of the range until before
the first occurrence of
target. -
dropWhile(
bool test(String)) → void -
Drops characters from the start of the range while they satisfy
test. -
endsWith(
Characters characters) → bool -
Whether the current range ends with
characters. -
expandAll(
) → void - Expands the range to the end of source.
-
expandBack(
[int count = 1]) → bool -
Expands the current range with the preceding
countcharacters. -
expandBackAll(
) → void - Expands the range back to the start of source.
-
expandBackTo(
Characters target) → bool -
Expands the range to include the previous occurrence of
target. -
expandBackUntil(
Characters target) → bool -
Expands the range to include characters back until the previous
target. -
expandBackWhile(
bool test(String)) → void -
Expands the range with the preceding characters satisfying
test. -
expandNext(
[int count = 1]) → bool -
Expands the current range with the next
countcharacters. -
expandTo(
Characters target) → bool -
Expands the range to include the next occurrence of
target. -
expandUntil(
Characters target) → bool -
Expands the range to include characters until the next
target. -
expandWhile(
bool test(String)) → void -
Expands the range with the following characters satisfying
test. -
isFollowedBy(
Characters characters) → bool -
Whether the current range is followed by
characters. -
isPrecededBy(
Characters characters) → bool -
Whether the current range is preceded by
characters. -
moveBack(
[int count = 1]) → bool -
Moves the range to be the last
countcharacters before the current range. -
moveBackAll(
) → void - Moves the range to be everything before the current range.
-
moveBackTo(
Characters target) → bool -
Moves the range to the last occurrence of
targetbefore the current range. -
moveBackUntil(
Characters target) → bool -
Moves to the range after the previous occurrence of
target. -
moveNext(
[int count = 1]) → bool -
Moves the range to be the next
countcharacters after the current range.override -
moveNextAll(
) → void - Moves the range to be everything after the current range.
-
moveTo(
Characters target) → bool -
Moves the range to the next occurrence of
targetafter the current range. -
moveUntil(
Characters target) → bool -
Moves to the range until the next occurrence of
target. -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
replaceAll(
Characters pattern, Characters replacement) → CharacterRange? -
Replaces
patternin the current range withreplacement. -
replaceFirst(
Characters pattern, Characters replacement) → CharacterRange? -
Replaces the first occurrence of
patternwithreplacement. -
replaceRange(
Characters replacement) → CharacterRange -
Replaces the current range with
replacementand returns the result. -
split(
Characters pattern, [int maxParts = 0]) → Iterable< CharacterRange> -
Splits the current range of characters at each occurrence of
pattern. -
startsWith(
Characters characters) → bool -
Whether the current range starts with
characters. -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited