A concrete subclass of CharacterIterator that iterates over the characters (code units or code points) in a UChar array. More...
#include <uchriter.h>
Public Member Functions | |
UCharCharacterIterator (const UChar *textPtr, int32_t length) | |
Create an iterator over the UChar array referred to by "textPtr". | |
UCharCharacterIterator (const UChar *textPtr, int32_t length, int32_t position) | |
Create an iterator over the UChar array referred to by "textPtr". | |
UCharCharacterIterator (const UChar *textPtr, int32_t length, int32_t textBegin, int32_t textEnd, int32_t position) | |
Create an iterator over the UChar array referred to by "textPtr". | |
UCharCharacterIterator (const UCharCharacterIterator &that) | |
Copy constructor. | |
virtual | ~UCharCharacterIterator () |
Destructor. | |
UCharCharacterIterator & | operator= (const UCharCharacterIterator &that) |
Assignment operator. | |
virtual UBool | operator== (const ForwardCharacterIterator &that) const |
Returns true if the iterators iterate over the same range of the same string and are pointing at the same character. | |
virtual int32_t | hashCode (void) const |
Generates a hash code for this iterator. | |
virtual CharacterIterator * | clone (void) const |
Returns a new UCharCharacterIterator referring to the same character in the same range of the same string as this one. | |
virtual UChar | first (void) |
Sets the iterator to refer to the first code unit in its iteration range, and returns that code unit. | |
virtual UChar | firstPostInc (void) |
Sets the iterator to refer to the first code unit in its iteration range, returns that code unit, and moves the position to the second code unit. | |
virtual UChar32 | first32 (void) |
Sets the iterator to refer to the first code point in its iteration range, and returns that code unit, This can be used to begin an iteration with next32(). | |
virtual UChar32 | first32PostInc (void) |
Sets the iterator to refer to the first code point in its iteration range, returns that code point, and moves the position to the second code point. | |
virtual UChar | last (void) |
Sets the iterator to refer to the last code unit in its iteration range, and returns that code unit. | |
virtual UChar32 | last32 (void) |
Sets the iterator to refer to the last code point in its iteration range, and returns that code unit. | |
virtual UChar | setIndex (int32_t position) |
Sets the iterator to refer to the "position"-th code unit in the text-storage object the iterator refers to, and returns that code unit. | |
virtual UChar32 | setIndex32 (int32_t position) |
Sets the iterator to refer to the beginning of the code point that contains the "position"-th code unit in the text-storage object the iterator refers to, and returns that code point. | |
virtual UChar | current (void) const |
Returns the code unit the iterator currently refers to. | |
virtual UChar32 | current32 (void) const |
Returns the code point the iterator currently refers to. | |
virtual UChar | next (void) |
Advances to the next code unit in the iteration range (toward endIndex()), and returns that code unit. | |
virtual UChar | nextPostInc (void) |
Gets the current code unit for returning and advances to the next code unit in the iteration range (toward endIndex()). | |
virtual UChar32 | next32 (void) |
Advances to the next code point in the iteration range (toward endIndex()), and returns that code point. | |
virtual UChar32 | next32PostInc (void) |
Gets the current code point for returning and advances to the next code point in the iteration range (toward endIndex()). | |
virtual UBool | hasNext () |
Returns FALSE if there are no more code units or code points at or after the current position in the iteration range. | |
virtual UChar | previous (void) |
Advances to the previous code unit in the iteration range (toward startIndex()), and returns that code unit. | |
virtual UChar32 | previous32 (void) |
Advances to the previous code point in the iteration range (toward startIndex()), and returns that code point. | |
virtual UBool | hasPrevious () |
Returns FALSE if there are no more code units or code points before the current position in the iteration range. | |
virtual int32_t | move (int32_t delta, EOrigin origin) |
Moves the current position relative to the start or end of the iteration range, or relative to the current position itself. | |
virtual int32_t | move32 (int32_t delta, EOrigin origin) |
Moves the current position relative to the start or end of the iteration range, or relative to the current position itself. | |
void | setText (const UChar *newText, int32_t newTextLength) |
Sets the iterator to iterate over a new range of text. | |
virtual void | getText (UnicodeString &result) |
Copies the UChar array under iteration into the UnicodeString referred to by "result". | |
virtual UClassID | getDynamicClassID (void) const |
Return a class ID for this object (not really public). | |
Static Public Member Functions | |
static UClassID | getStaticClassID (void) |
Return a class ID for this class (not really public). | |
Protected Member Functions | |
UCharCharacterIterator () | |
Protected constructor. | |
Protected Attributes | |
const UChar * | text |
Protected member text. |
A concrete subclass of CharacterIterator that iterates over the characters (code units or code points) in a UChar array.
It's possible not only to create an iterator that iterates over an entire UChar array, but also to create one that iterates over only a subrange of a UChar array (iterators over different subranges of the same UChar array don't compare equal).
Definition at line 33 of file uchriter.h.
icu::UCharCharacterIterator::UCharCharacterIterator | ( | const UChar * | textPtr, | |
int32_t | length | |||
) |
Create an iterator over the UChar array referred to by "textPtr".
The iteration range is 0 to length-1
. text is only aliased, not adopted (the destructor will not delete it).
textPtr | The UChar array to be iterated over | |
length | The length of the UChar array |
icu::UCharCharacterIterator::UCharCharacterIterator | ( | const UChar * | textPtr, | |
int32_t | length, | |||
int32_t | position | |||
) |
Create an iterator over the UChar array referred to by "textPtr".
The iteration range is 0 to length-1
. text is only aliased, not adopted (the destructor will not delete it). The starting position is specified by "position". If "position" is outside the valid iteration range, the behavior of this object is undefined.
textPtr | The UChar array to be iteratd over | |
length | The length of the UChar array | |
position | The starting position of the iteration |
icu::UCharCharacterIterator::UCharCharacterIterator | ( | const UChar * | textPtr, | |
int32_t | length, | |||
int32_t | textBegin, | |||
int32_t | textEnd, | |||
int32_t | position | |||
) |
Create an iterator over the UChar array referred to by "textPtr".
The iteration range is 0 to end-1
. text is only aliased, not adopted (the destructor will not delete it). The starting position is specified by "position". If begin and end do not form a valid iteration range or "position" is outside the valid iteration range, the behavior of this object is undefined.
textPtr | The UChar array to be iterated over | |
length | The length of the UChar array | |
textBegin | The begin position of the iteration range | |
textEnd | The end position of the iteration range | |
position | The starting position of the iteration |
icu::UCharCharacterIterator::UCharCharacterIterator | ( | const UCharCharacterIterator & | that | ) |
Copy constructor.
The new iterator iterates over the same range of the same string as "that", and its initial position is the same as "that"'s current position.
that | The UCharCharacterIterator to be copied |
virtual icu::UCharCharacterIterator::~UCharCharacterIterator | ( | ) | [virtual] |
Destructor.
icu::UCharCharacterIterator::UCharCharacterIterator | ( | ) | [protected] |
Protected constructor.
virtual CharacterIterator* icu::UCharCharacterIterator::clone | ( | void | ) | const [virtual] |
Returns a new UCharCharacterIterator referring to the same character in the same range of the same string as this one.
The caller must delete the new iterator.
Implements icu::CharacterIterator.
Reimplemented in icu::StringCharacterIterator.
virtual UChar icu::UCharCharacterIterator::current | ( | void | ) | const [virtual] |
Returns the code unit the iterator currently refers to.
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::current32 | ( | void | ) | const [virtual] |
Returns the code point the iterator currently refers to.
Implements icu::CharacterIterator.
virtual UChar icu::UCharCharacterIterator::first | ( | void | ) | [virtual] |
Sets the iterator to refer to the first code unit in its iteration range, and returns that code unit.
This can be used to begin an iteration with next().
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::first32 | ( | void | ) | [virtual] |
Sets the iterator to refer to the first code point in its iteration range, and returns that code unit, This can be used to begin an iteration with next32().
Note that an iteration with next32PostInc(), beginning with, e.g., setToStart() or firstPostInc(), is more efficient.
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::first32PostInc | ( | void | ) | [virtual] |
Sets the iterator to refer to the first code point in its iteration range, returns that code point, and moves the position to the second code point.
This is an alternative to setToStart() for forward iteration with next32PostInc().
Reimplemented from icu::CharacterIterator.
virtual UChar icu::UCharCharacterIterator::firstPostInc | ( | void | ) | [virtual] |
Sets the iterator to refer to the first code unit in its iteration range, returns that code unit, and moves the position to the second code unit.
This is an alternative to setToStart() for forward iteration with nextPostInc().
Reimplemented from icu::CharacterIterator.
virtual UClassID icu::UCharCharacterIterator::getDynamicClassID | ( | void | ) | const [virtual] |
Return a class ID for this object (not really public).
Implements icu::ForwardCharacterIterator.
Reimplemented in icu::StringCharacterIterator.
static UClassID icu::UCharCharacterIterator::getStaticClassID | ( | void | ) | [static] |
Return a class ID for this class (not really public).
Reimplemented in icu::StringCharacterIterator.
virtual void icu::UCharCharacterIterator::getText | ( | UnicodeString & | result | ) | [virtual] |
Copies the UChar array under iteration into the UnicodeString referred to by "result".
Even if this iterator iterates across only a part of this string, the whole string is copied.
result | Receives a copy of the text under iteration. |
Implements icu::CharacterIterator.
Reimplemented in icu::StringCharacterIterator.
virtual int32_t icu::UCharCharacterIterator::hashCode | ( | void | ) | const [virtual] |
Generates a hash code for this iterator.
Implements icu::ForwardCharacterIterator.
virtual UBool icu::UCharCharacterIterator::hasNext | ( | ) | [virtual] |
Returns FALSE if there are no more code units or code points at or after the current position in the iteration range.
This is used with nextPostInc() or next32PostInc() in forward iteration.
Implements icu::ForwardCharacterIterator.
virtual UBool icu::UCharCharacterIterator::hasPrevious | ( | ) | [virtual] |
Returns FALSE if there are no more code units or code points before the current position in the iteration range.
This is used with previous() or previous32() in backward iteration.
Implements icu::CharacterIterator.
virtual UChar icu::UCharCharacterIterator::last | ( | void | ) | [virtual] |
Sets the iterator to refer to the last code unit in its iteration range, and returns that code unit.
This can be used to begin an iteration with previous().
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::last32 | ( | void | ) | [virtual] |
Sets the iterator to refer to the last code point in its iteration range, and returns that code unit.
This can be used to begin an iteration with previous32().
Implements icu::CharacterIterator.
virtual int32_t icu::UCharCharacterIterator::move | ( | int32_t | delta, | |
EOrigin | origin | |||
) | [virtual] |
Moves the current position relative to the start or end of the iteration range, or relative to the current position itself.
The movement is expressed in numbers of code units forward or backward by specifying a positive or negative delta.
delta | the position relative to origin. A positive delta means forward; a negative delta means backward. | |
origin | Origin enumeration {kStart, kCurrent, kEnd} |
Implements icu::CharacterIterator.
virtual int32_t icu::UCharCharacterIterator::move32 | ( | int32_t | delta, | |
EOrigin | origin | |||
) | [virtual] |
Moves the current position relative to the start or end of the iteration range, or relative to the current position itself.
The movement is expressed in numbers of code points forward or backward by specifying a positive or negative delta.
delta | the position relative to origin. A positive delta means forward; a negative delta means backward. | |
origin | Origin enumeration {kStart, kCurrent, kEnd} |
Implements icu::CharacterIterator.
virtual UChar icu::UCharCharacterIterator::next | ( | void | ) | [virtual] |
Advances to the next code unit in the iteration range (toward endIndex()), and returns that code unit.
If there are no more code units to return, returns DONE.
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::next32 | ( | void | ) | [virtual] |
Advances to the next code point in the iteration range (toward endIndex()), and returns that code point.
If there are no more code points to return, returns DONE. Note that iteration with "pre-increment" semantics is less efficient than iteration with "post-increment" semantics that is provided by next32PostInc().
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::next32PostInc | ( | void | ) | [virtual] |
Gets the current code point for returning and advances to the next code point in the iteration range (toward endIndex()).
If there are no more code points to return, returns DONE.
Implements icu::ForwardCharacterIterator.
virtual UChar icu::UCharCharacterIterator::nextPostInc | ( | void | ) | [virtual] |
Gets the current code unit for returning and advances to the next code unit in the iteration range (toward endIndex()).
If there are no more code units to return, returns DONE.
Implements icu::ForwardCharacterIterator.
UCharCharacterIterator& icu::UCharCharacterIterator::operator= | ( | const UCharCharacterIterator & | that | ) |
Assignment operator.
*this is altered to iterate over the sane range of the same string as "that", and refers to the same character within that string as "that" does.
that | The object to be copied |
Reimplemented from icu::CharacterIterator.
Reimplemented in icu::StringCharacterIterator.
virtual UBool icu::UCharCharacterIterator::operator== | ( | const ForwardCharacterIterator & | that | ) | const [virtual] |
Returns true if the iterators iterate over the same range of the same string and are pointing at the same character.
that | The ForwardCharacterIterator used to be compared for equality |
Reimplemented in icu::StringCharacterIterator.
virtual UChar icu::UCharCharacterIterator::previous | ( | void | ) | [virtual] |
Advances to the previous code unit in the iteration range (toward startIndex()), and returns that code unit.
If there are no more code units to return, returns DONE.
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::previous32 | ( | void | ) | [virtual] |
Advances to the previous code point in the iteration range (toward startIndex()), and returns that code point.
If there are no more code points to return, returns DONE.
Implements icu::CharacterIterator.
virtual UChar icu::UCharCharacterIterator::setIndex | ( | int32_t | position | ) | [virtual] |
Sets the iterator to refer to the "position"-th code unit in the text-storage object the iterator refers to, and returns that code unit.
position | the position within the text-storage object |
Implements icu::CharacterIterator.
virtual UChar32 icu::UCharCharacterIterator::setIndex32 | ( | int32_t | position | ) | [virtual] |
Sets the iterator to refer to the beginning of the code point that contains the "position"-th code unit in the text-storage object the iterator refers to, and returns that code point.
The current position is adjusted to the beginning of the code point (its first code unit).
position | the position within the text-storage object |
Implements icu::CharacterIterator.
void icu::UCharCharacterIterator::setText | ( | const UChar * | newText, | |
int32_t | newTextLength | |||
) |
Sets the iterator to iterate over a new range of text.
Reimplemented in icu::StringCharacterIterator.
const UChar* icu::UCharCharacterIterator::text [protected] |
Protected member text.
Reimplemented in icu::StringCharacterIterator.
Definition at line 376 of file uchriter.h.