To iterate over code points and strings, use a loop like this: *
* UnicodeSetIterator it(set);
* while (it.next()) {
* processItem(it.getString());
* }
*
* Each item in the set is accessed as a string. Set elements * consisting of single code points are returned as strings containing * just the one code point. * *
To iterate over code point ranges, instead of individual code points, * use a loop like this: *
* UnicodeSetIterator it(set);
* while (it.nextRange()) {
* if (it.isString()) {
* processString(it.getString());
* } else {
* processCodepointRange(it.getCodepoint(), it.getCodepointEnd());
* }
* }
*
* @author M. Davis
* @stable ICU 2.4
*/
class U_COMMON_API UnicodeSetIterator : public UObject {
protected:
/**
* Value of codepoint if the iterator points to a string.
* If codepoint == IS_STRING, then examine
* string for the current iteration result.
* @stable ICU 2.4
*/
enum { IS_STRING = -1 };
/**
* Current code point, or the special value IS_STRING, if
* the iterator points to a string.
* @stable ICU 2.4
*/
UChar32 codepoint;
/**
* When iterating over ranges using nextRange(),
* codepointEnd contains the inclusive end of the
* iteration range, if codepoint != IS_STRING. If
* iterating over code points using next(), or if
* codepoint == IS_STRING, then the value of
* codepointEnd is undefined.
* @stable ICU 2.4
*/
UChar32 codepointEnd;
/**
* If codepoint == IS_STRING, then string points
* to the current string. If codepoint != IS_STRING, the
* value of string is undefined.
* @stable ICU 2.4
*/
const UnicodeString* string;
public:
/**
* Create an iterator over the given set. The iterator is valid
* only so long as set is valid.
* @param set set to iterate over
* @stable ICU 2.4
*/
UnicodeSetIterator(const UnicodeSet& set);
/**
* Create an iterator over nothing. next() and
* nextRange() return false. This is a convenience
* constructor allowing the target to be set later.
* @stable ICU 2.4
*/
UnicodeSetIterator();
/**
* Destructor.
* @stable ICU 2.4
*/
virtual ~UnicodeSetIterator();
/**
* Returns true if the current element is a string. If so, the
* caller can retrieve it with getString(). If this
* method returns false, the current element is a code point or
* code point range, depending on whether next() or
* nextRange() was called.
* Eleme