Go to the documentation of this file.
17 #if U_SHOW_CPLUSPLUS_API
101 enum { DONE = 0xffff };
432 inline int32_t setToStart();
441 virtual char16_t
last(
void) = 0;
459 inline int32_t setToEnd();
505 virtual char16_t
next(
void) = 0;
558 inline int32_t startIndex(
void)
const;
569 inline int32_t endIndex(
void)
const;
579 inline int32_t getIndex(
void)
const;
587 inline int32_t getLength()
const;
701 CharacterIterator::setToStart() {
702 return move(0, kStart);
706 CharacterIterator::setToEnd() {
707 return move(0, kEnd);
711 CharacterIterator::startIndex(
void)
const {
716 CharacterIterator::endIndex(
void)
const {
721 CharacterIterator::getIndex(
void)
const {
726 CharacterIterator::getLength(
void)
const {
ForwardCharacterIterator()
Default constructor to be overridden in the implementing class.
virtual UBool hasNext()=0
Returns FALSE if there are no more code units or code points at or after the current position in the ...
virtual ~ForwardCharacterIterator()
Destructor.
int32_t textLength
Base class text length field.
int32_t begin
Base class field for the start of the iteration range.
Basic definitions for ICU, for both C and C++ APIs.
virtual char16_t next(void)=0
Advances to the next code unit in the iteration range (toward endIndex()), and returns that code unit...
virtual ~CharacterIterator()
Destructor.
int32_t pos
Base class field for the current position.
int8_t UBool
The ICU boolean type.
CharacterIterator & operator=(const CharacterIterator &that)
Assignment operator.
virtual char16_t setIndex(int32_t position)=0
Sets the iterator to refer to the "position"-th code unit in the text-storage object the iterator ref...
virtual UChar32 first32PostInc(void)
Sets the iterator to refer to the first code point in its iteration range, returns that code point,...
virtual char16_t current(void) const =0
Returns the code unit the iterator currently refers to.
virtual UChar32 last32(void)=0
Sets the iterator to refer to the last code point in its iteration range, and returns that code unit.
virtual int32_t move32(int32_t delta, EOrigin origin)=0
Moves the current position relative to the start or end of the iteration range, or relative to the cu...
U_EXPORT UBool operator==(const StringPiece &x, const StringPiece &y)
Global operator == for StringPiece.
virtual int32_t move(int32_t delta, EOrigin origin)=0
Moves the current position relative to the start or end of the iteration range, or relative to the cu...
ForwardCharacterIterator & operator=(const ForwardCharacterIterator &)
Assignment operator to be overridden in the implementing class.
virtual int32_t hashCode(void) const =0
Generates a hash code for this iterator.
virtual void getText(UnicodeString &result)=0
Copies the text under iteration into the UnicodeString referred to by "result".
CharacterIterator(int32_t length)
Constructor, just setting the length field in this base class.
virtual UChar32 current32(void) const =0
Returns the code point the iterator currently refers to.
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
virtual UChar32 setIndex32(int32_t position)=0
Sets the iterator to refer to the beginning of the code point that contains the "position"-th code un...
virtual char16_t first(void)=0
Sets the iterator to refer to the first code unit in its iteration range, and returns that code unit.
virtual char16_t firstPostInc(void)
Sets the iterator to refer to the first code unit in its iteration range, returns that code unit,...
int32_t UChar32
Define UChar32 as a type for single Unicode code points.
virtual UChar32 previous32(void)=0
Advances to the previous code point in the iteration range (toward startIndex()), and returns that co...
UObject is the common ICU "boilerplate" class.
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
CharacterIterator(const CharacterIterator &that)
Copy constructor.
Abstract class that defines an API for forward-only iteration on text objects.
virtual UChar32 next32PostInc(void)=0
Gets the current code point for returning and advances to the next code point in the iteration range ...
EOrigin
Origin enumeration for the move() and move32() functions.
virtual UClassID getDynamicClassID(void) const =0
Returns a UClassID for this ForwardCharacterIterator ("poor man's RTTI").
UBool operator!=(const StringPiece &x, const StringPiece &y)
Global operator != for StringPiece.
virtual char16_t last(void)=0
Sets the iterator to refer to the last code unit in its iteration range, and returns that code unit.
CharacterIterator(int32_t length, int32_t position)
Constructor, just setting the length and position fields in this base class.
ForwardCharacterIterator(const ForwardCharacterIterator &other)
Copy constructor to be overridden in the implementing class.
virtual UBool operator==(const ForwardCharacterIterator &that) const =0
Returns true when both iterators refer to the same character in the same character-storage object.
Abstract class that defines an API for iteration on text objects.
virtual UChar32 next32(void)=0
Advances to the next code point in the iteration range (toward endIndex()), and returns that code poi...
CharacterIterator()
Empty constructor.
virtual UChar32 first32(void)=0
Sets the iterator to refer to the first code point in its iteration range, and returns that code unit...
virtual char16_t nextPostInc(void)=0
Gets the current code unit for returning and advances to the next code unit in the iteration range (t...
virtual CharacterIterator * clone() const =0
Returns a pointer to a new CharacterIterator of the same concrete class as this one,...
C++ API: Common ICU base class UObject.
CharacterIterator(int32_t length, int32_t textBegin, int32_t textEnd, int32_t position)
Constructor, just setting the length, start, end, and position fields in this base class.
virtual UBool hasPrevious()=0
Returns FALSE if there are no more code units or code points before the current position in the itera...
virtual char16_t previous(void)=0
Advances to the previous code unit in the iteration range (toward startIndex()), and returns that cod...
int32_t end
Base class field for the end of the iteration range.