|
UtfString
|
An iterator that iterates through the code points in a Unicode string, but allowing only access to constant code points. More...
#include <UnicodeString.h>
Inherits iterator< std::random_access_iterator_tag, UnicodeChar >.
Public Member Functions | |
| const_iterator () | |
| Creates an empty constant iterator. More... | |
| const_iterator (const Utf8String::const_iterator &utf8StringIterator) | |
| Constructs a constant iterator for UnicodeString using a Utf8String iterator. More... | |
| const_iterator (const Utf16String::const_iterator &utf16StringIterator) | |
| Constructs a constant iterator for UnicodeString using a Utf16String iterator. More... | |
| const_iterator (UnicodeString::iterator &otherIterator) | |
| Constructs a constant iterator for UnicodeString using a non-constant iterator. More... | |
| const_iterator (const UnicodeString::const_iterator &otherIterator) | |
| Constructs a constant iterator for UnicodeString using another constant iterator. More... | |
| const_iterator (const UnicodeString::const_reverse_iterator &reverseIterator) | |
| Constructs a constant iterator for UnicodeString using a constant reverse iterator. More... | |
| ~const_iterator () | |
| Cleans up before the iterator is destroyed. | |
| bool | empty () const |
| Indicates whether this iterator is an empty iterator. More... | |
| const_iterator & | operator= (const const_iterator &otherIterator) |
| Assigns the value of another iterator to this iterator. More... | |
| bool | operator== (const const_iterator &otherIterator) const |
| Compares this iterator with another iterator and tests for equality. More... | |
| bool | operator!= (const const_iterator &otherIterator) const |
| Compares this iterator with another iterator and tests for inequality. More... | |
| bool | operator< (const const_iterator &otherIterator) |
| Compares this iterator to another iterator and tests whether this iterator comes before the other iterator in the string. More... | |
| bool | operator<= (const const_iterator &otherIterator) |
| Compares this iterator to another iterator and tests whether this iterator comes before or is at the same position the other iterator in the string. More... | |
| bool | operator> (const const_iterator &otherIterator) |
| Compares this iterator to another iterator and tests whether this iterator comes after the other iterator in the string. More... | |
| bool | operator>= (const const_iterator &otherIterator) |
| Compares this iterator to another iterator and tests whether this iterator comes after or is at the same position the other iterator in the string. More... | |
| const_iterator & | operator++ () |
| Increments this iterator to the next position in the UnicodeString. More... | |
| const_iterator | operator++ (int) |
| Increments this iterator to the next position in the UnicodeString. More... | |
| const_iterator & | operator+= (size_t offset) |
| Increments this iterator by a specific offset. More... | |
| const_iterator | operator+ (size_t offset) |
| Creates an iterator that has the position of this iterator incremented by a specific offset. More... | |
| const_iterator & | operator-- () |
| Decrements this iterator to the previous position in the UnicodeString. More... | |
| const_iterator | operator-- (int) |
| Decrements this iterator to the previous position in the UnicodeString. More... | |
| const_iterator & | operator-= (size_t offset) |
| Decrements this iterator by a specific offset. More... | |
| const_iterator | operator- (size_t offset) |
| Creates an iterator that has the position of this iterator decremented by a specific offset. More... | |
| const UnicodeChar | operator* () |
| Gets the character at the position of this iterator. More... | |
| const UnicodeChar * | operator-> () |
| Gets a pointer to the character at the position of this iterator. More... | |
An iterator that iterates through the code points in a Unicode string, but allowing only access to constant code points.
This iterator assumes that the Unicode string being iterated over is a valid Unicode string.
There is also the concept of an "empty" iterator. An empty iterator is one that is created when begin() or end() is called on an empty UnicodeString. Attempting to change the position of an empty iterator using unary operator (such as "+=") will only result in nothing happening. Attempting to get an iterator for another position using a binary operator (such as "+") will result in another empty iterator being created. Dereferencing an iterator via the "*" or "->" operators will result in an assertion failure in a debug build or undefined behavior in a release build. Empty iterators are always equal to each other.
| UtfString::UnicodeString::const_iterator::const_iterator | ( | ) |
Creates an empty constant iterator.
For a description of an empty iterator, see the class description
| UtfString::UnicodeString::const_iterator::const_iterator | ( | const Utf8String::const_iterator & | utf8StringIterator) |
Constructs a constant iterator for UnicodeString using a Utf8String iterator.
This function assumes that utf8StringIterator is a valid iterator
| [in] | utf8StringIterator | The Utf8String iterator to use in constructing this iterator |
| UtfString::UnicodeString::const_iterator::const_iterator | ( | const Utf16String::const_iterator & | utf16StringIterator) |
Constructs a constant iterator for UnicodeString using a Utf16String iterator.
This function assumes that utf16StringIterator is a valid iterator
| [in] | utf16StringIterator | The Utf16String iterator to use in constructing this iterator |
| UtfString::UnicodeString::const_iterator::const_iterator | ( | UnicodeString::iterator & | otherIterator) |
Constructs a constant iterator for UnicodeString using a non-constant iterator.
This iterator will take on the same characteristics and position as the other iterator
| [in] | otherIterator | The other iterator to use in constructing this iterator |
| UtfString::UnicodeString::const_iterator::const_iterator | ( | const UnicodeString::const_iterator & | otherIterator) |
Constructs a constant iterator for UnicodeString using another constant iterator.
This iterator will take on the same characteristics and position as the other iterator
| [in] | otherIterator | The other iterator to use in constructing this iterator |
| UtfString::UnicodeString::const_iterator::const_iterator | ( | const UnicodeString::const_reverse_iterator & | reverseIterator) |
Constructs a constant iterator for UnicodeString using a constant reverse iterator.
This constant iterator will take on the same position as the constant reverse iterator.
| [in] | reverseIterator | The constant reverse iterator to use in constructing this constant iterator |
| bool UtfString::UnicodeString::const_iterator::empty | ( | ) | const |
Indicates whether this iterator is an empty iterator.
This is mainly for informational purposes. If you use iterators properly, comparing the begin iterator to the end iterator, you won't even need to know when an empty iterator appears. In case want to know whether an iterator is empty (as opposed to an non-empty iterator that has been incremented/decremented beyond the boundaries of a string), you can use this function.
| bool UtfString::UnicodeString::const_iterator::operator!= | ( | const const_iterator & | otherIterator) | const |
Compares this iterator with another iterator and tests for inequality.
Empty iterators are always equal to other empty iterators and are always unequal to non-empty iterators.
| [in] | otherIterator | The other iterator to be compared with this iterator |
| const UnicodeChar UtfString::UnicodeString::const_iterator::operator* | ( | ) |
Gets the character at the position of this iterator.
If this iterator is not pointing to a position in a UnicodeString, the result will be undefined.
The reference returned by this function will be invalidated if the iterator is changed in any way. Changing the value of the returned object will not change the string.
If this iterator is an empty iterator, using this operator will result in an assertion failure in a debug build and undefined behavior (most likely a crash) in a release build.
| const_iterator UtfString::UnicodeString::const_iterator::operator+ | ( | size_t | offset) |
Creates an iterator that has the position of this iterator incremented by a specific offset.
Note that since a Unicode string contains variable-width characters, we have to iterate over the code units. As a result, this operator has a performance of O(N). Hence, this operator should be used with care.
| [in] | offset | The offset to be used when incrementing this position of this iterator |
| const_iterator& UtfString::UnicodeString::const_iterator::operator++ | ( | ) |
Increments this iterator to the next position in the UnicodeString.
This is the prefix operator.
| const_iterator UtfString::UnicodeString::const_iterator::operator++ | ( | int | ) |
Increments this iterator to the next position in the UnicodeString.
This is a postfix operator.
| const_iterator& UtfString::UnicodeString::const_iterator::operator+= | ( | size_t | offset) |
Increments this iterator by a specific offset.
Note that since a Unicode string contains variable-width characters, we have to iterate over the code units. As a result, this operator has a performance of O(N). Hence, this operator should be used with care.
| [in] | offset | The offset to use in incrementing this iterator |
| const_iterator UtfString::UnicodeString::const_iterator::operator- | ( | size_t | offset) |
Creates an iterator that has the position of this iterator decremented by a specific offset.
Note that since a Unicode string contains variable-width characters, we have to iterate over the code units. As a result, this operator has a performance of O(N). Hence, this operator should be used with care.
| [in] | offset | The offset to use in decrementing the position of this iterator |
| const_iterator& UtfString::UnicodeString::const_iterator::operator-- | ( | ) |
Decrements this iterator to the previous position in the UnicodeString.
This is a prefix operator.
| const_iterator UtfString::UnicodeString::const_iterator::operator-- | ( | int | ) |
Decrements this iterator to the previous position in the UnicodeString.
This is a postfix operator.
| const_iterator& UtfString::UnicodeString::const_iterator::operator-= | ( | size_t | offset) |
Decrements this iterator by a specific offset.
Note that since a Unicode string contains variable-width characters, we have to iterate over the code units. As a result, this operator has a performance of O(N). Hence, this operator should be used with care.
| [in] | offset | The offset to use in decrementing this iterator |
| const UnicodeChar* UtfString::UnicodeString::const_iterator::operator-> | ( | ) |
Gets a pointer to the character at the position of this iterator.
If this iterator is not pointing to a position in a UnicodeString, the result will be undefined.
The pointer returned by this function will be invalidated if the iterator is changed in any way.
If this iterator is an empty iterator, using this operator will result in an assertion failure in a debug build and undefined behavior (most likely a crash) in a release build.
| bool UtfString::UnicodeString::const_iterator::operator< | ( | const const_iterator & | otherIterator) |
Compares this iterator to another iterator and tests whether this iterator comes before the other iterator in the string.
Empty iterators are considered to be less than non-empty iterators.
This operator has a performance of O(1).
| [in] | otherIterator | The other iterator to be compared with this iterator |
| bool UtfString::UnicodeString::const_iterator::operator<= | ( | const const_iterator & | otherIterator) |
Compares this iterator to another iterator and tests whether this iterator comes before or is at the same position the other iterator in the string.
Empty iterators are considered to be less than non-empty iterators.
This operator has a performance of O(1).
| [in] | otherIterator | The other iterator to be compared with this iterator |
| const_iterator& UtfString::UnicodeString::const_iterator::operator= | ( | const const_iterator & | otherIterator) |
Assigns the value of another iterator to this iterator.
This iterator will take on the same characteristics and position as the other iterator
| [in] | otherIterator | The other iterator to be assigned to this iterator |
| bool UtfString::UnicodeString::const_iterator::operator== | ( | const const_iterator & | otherIterator) | const |
Compares this iterator with another iterator and tests for equality.
Empty iterators are always equal to other empty iterators and are always unequal to non-empty iterators.
| [in] | otherIterator | The other iterator to be compared with this iterator |
| bool UtfString::UnicodeString::const_iterator::operator> | ( | const const_iterator & | otherIterator) |
Compares this iterator to another iterator and tests whether this iterator comes after the other iterator in the string.
Non-Empty iterators are considered to be greater than than empty iterators.
This operator has a performance of O(1).
| [in] | otherIterator | The other iterator to be compared with this iterator |
| bool UtfString::UnicodeString::const_iterator::operator>= | ( | const const_iterator & | otherIterator) |
Compares this iterator to another iterator and tests whether this iterator comes after or is at the same position the other iterator in the string.
Non-Empty iterators are considered to be greater than than empty iterators.
This operator has a performance of O(1).
| [in] | otherIterator | The other iterator to be compared with this iterator |
1.8.4