Abstract class that defines an API for forward-only iteration on text objects. More...
Abstract class that defines an API for forward-only iteration on text objects.
This is a minimal interface for iteration without random access or backwards iteration. It is especially useful for wrapping streams with converters into an object for collation or normalization.
Characters can be accessed in two ways: as code units or as code points. Unicode code points are 21-bit integers and are the scalar values of Unicode characters. ICU uses the type UChar32 for them. Unicode code units are the storage units of a given Unicode/UCS Transformation Format (a character encoding scheme). With UTF-16, all code points can be represented with either one or two code units ("surrogates"). String storage is typically based on code units, while properties of characters are typically determined using code point values. Some processes may be designed to work with sequences of code units, or it may be known that all characters that are important to an algorithm can be represented with single code units. Other processes will need to use the code point access functions.
ForwardCharacterIterator provides nextPostInc() to access a code unit and advance an internal position into the text object, similar to a return text[position++].
It provides next32PostInc() to access a code point and advance an internal position.
next32PostInc() assumes that the current position is that of the beginning of a code point, i.e., of its first code unit. After next32PostInc(), this will be true again. In general, access to code units and code points in the same iteration loop should not be mixed. In UTF-16, if the current position is on a second code unit (Low Surrogate), then only that code unit is returned even by next32PostInc().
For iteration with either function, there are two ways to check for the end of the iteration. When there are no more characters in the text object:
Example:
while(it.hasNext()) {
c=it.next32PostInc();
}
}
char16_t c;
while((c=it.nextPostInc())!=ForwardCharacterIterator::DONE) {
}
}
ForwardCharacterIterator()
Default constructor to be overridden in the implementing class.
int32_t UChar32
Define UChar32 as a type for single Unicode code points.
Definition at line 94 of file chariter.h.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4