ICU 78.1 78.1 |
C API for code unit iteration.More...
#include <uiter.h>
Data Fields | |
| const void * | context |
| (protected) Pointer to string or wrapped object or similar.More... | |
| int32_t | length |
| (protected) Length of string or similar.More... | |
| int32_t | start |
| (protected) Start index or similar.More... | |
| int32_t | index |
| (protected) Current index or similar.More... | |
| int32_t | limit |
| (protected) Limit index or similar.More... | |
| int32_t | reservedField |
| (protected) Used by UTF-8 iterators and possibly others.More... | |
| UCharIteratorGetIndex * | getIndex |
| (public) Returns the current position or the start or limit index of the iteration range.More... | |
| UCharIteratorMove * | move |
| (public) Moves the current position relative to the start or limit of the iteration range, or relative to the current position itself.More... | |
| UCharIteratorHasNext * | hasNext |
| (public) Check ifcurrent() andnext() can still return another code unit.More... | |
| UCharIteratorHasPrevious * | hasPrevious |
| (public) Check ifprevious() can still return another code unit.More... | |
| UCharIteratorCurrent * | current |
| (public) Return the code unit at the current position, or U_SENTINEL if there is none (index is at the limit).More... | |
| UCharIteratorNext * | next |
| (public) Return the code unit at the current index and increment the index (post-increment, like s[i++]), or return U_SENTINEL if there is none (index is at the limit).More... | |
| UCharIteratorPrevious * | previous |
| (public) Decrement the index and return the code unit from there (pre-decrement, like s[–i]), or return U_SENTINEL if there is none (index is at the start).More... | |
| UCharIteratorReserved * | reservedFn |
| (public) Reserved for future use.More... | |
| UCharIteratorGetState * | getState |
| (public) Return the state of the iterator, to be restored later withsetState().More... | |
| UCharIteratorSetState * | setState |
| (public) Restore the iterator state from the state word from a call togetState().More... | |
C API for code unit iteration.
This can be used as a C wrapper around CharacterIterator, Replaceable, or implemented using simple strings, etc.
There are two roles for usingUCharIterator:
A "provider" sets the necessary function pointers and controls the "protected" fields of theUCharIterator structure. A "provider" passes aUCharIterator into C APIs that need aUCharIterator as an abstract, flexible string interface.
Implementations of such C APIs are "callers" ofUCharIterator functions; they only use the "public" function pointers and never access the "protected" fields directly.
Thecurrent() andnext() functions only check the current index against the limit, andprevious() only checks the current index against the start, to see if the iterator already reached the end of the iteration range.
The assumption - in all iterators - is that the index is moved via the API, which means it won't go out of bounds, or the index is modified by user code that knows enough about the iterator implementation to set valid index values.
UCharIterator functions return code unit values 0..0xffff, or U_SENTINEL if the iteration bounds are reached.
| const void* UCharIterator::context |
| UCharIteratorCurrent* UCharIterator::current |
(public) Return the code unit at the current position, or U_SENTINEL if there is none (index is at the limit).
| UCharIteratorGetIndex* UCharIterator::getIndex |
(public) Returns the current position or the start or limit index of the iteration range.
| UCharIteratorGetState* UCharIterator::getState |
(public) Return the state of the iterator, to be restored later withsetState().
This function pointer is NULL if the iterator does not implement it.
| UCharIteratorHasNext* UCharIterator::hasNext |
| UCharIteratorHasPrevious* UCharIterator::hasPrevious |
(public) Check ifprevious() can still return another code unit.
| int32_t UCharIterator::index |
| int32_t UCharIterator::length |
| int32_t UCharIterator::limit |
| UCharIteratorMove* UCharIterator::move |
(public) Moves the current position relative to the start or limit 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.
| UCharIteratorNext* UCharIterator::next |
(public) Return the code unit at the current index and increment the index (post-increment, like s[i++]), or return U_SENTINEL if there is none (index is at the limit).
| UCharIteratorPrevious* UCharIterator::previous |
(public) Decrement the index and return the code unit from there (pre-decrement, like s[–i]), or return U_SENTINEL if there is none (index is at the start).
| int32_t UCharIterator::reservedField |
| UCharIteratorReserved* UCharIterator::reservedFn |
| UCharIteratorSetState* UCharIterator::setState |
(public) Restore the iterator state from the state word from a call togetState().
This function pointer is NULL if the iterator does not implement it.
| int32_t UCharIterator::start |
1.9.1