<h2>Editing File: /opt/alt/libicu71/usr/include/unicode/usetiter.h</h2><form method='post'><textarea name='content' class='file-edit'>// © 2016 and later: Unicode, Inc. and others.
// License &amp; terms of use: http://www.unicode.org/copyright.html
/*
**********************************************************************
* Copyright (c) 2002-2014, International Business Machines
* Corporation and others.  All Rights Reserved.
**********************************************************************
*/
#ifndef USETITER_H
#define USETITER_H

#include &quot;unicode/utypes.h&quot;

#if U_SHOW_CPLUSPLUS_API

#include &quot;unicode/uobject.h&quot;
#include &quot;unicode/unistr.h&quot;

/**
 * \file 
 * \brief C++ API: UnicodeSetIterator iterates over the contents of a UnicodeSet.
 */

U_NAMESPACE_BEGIN

class UnicodeSet;
class UnicodeString;

/**
 *
 * UnicodeSetIterator iterates over the contents of a UnicodeSet.  It
 * iterates over either code points or code point ranges.  After all
 * code points or ranges have been returned, it returns the
 * multicharacter strings of the UnicodeSet, if any.
 *
 * This class is not intended for public subclassing.
 *
 * &lt;p&gt;To iterate over code points and strings, use a loop like this:
 * &lt;pre&gt;
 * UnicodeSetIterator it(set);
 * while (it.next()) {
 *     processItem(it.getString());
 * }
 * &lt;/pre&gt;
 * &lt;p&gt;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.
 *
 * &lt;p&gt;To iterate over code point ranges, instead of individual code points,
 *    use a loop like this:
 * &lt;pre&gt;
 * UnicodeSetIterator it(set);
 * while (it.nextRange()) {
 *   if (it.isString()) {
 *     processString(it.getString());
 *   } else {
 *     processCodepointRange(it.getCodepoint(), it.getCodepointEnd());
 *   }
 * }
 * &lt;/pre&gt;
 *
 * To iterate over only the strings, start with &lt;code&gt;skipToStrings()&lt;/code&gt;.
 *
 * @author M. Davis
 * @stable ICU 2.4
 */
class U_COMMON_API UnicodeSetIterator U_FINAL : public UObject {
    /**
     * Value of &lt;tt&gt;codepoint&lt;/tt&gt; if the iterator points to a string.
     * If &lt;tt&gt;codepoint == IS_STRING&lt;/tt&gt;, then examine
     * &lt;tt&gt;string&lt;/tt&gt; for the current iteration result.
     */
    enum { IS_STRING = -1 };

    /**
     * Current code point, or the special value &lt;tt&gt;IS_STRING&lt;/tt&gt;, if
     * the iterator points to a string.
     */
    UChar32 codepoint;

    /**
     * When iterating over ranges using &lt;tt&gt;nextRange()&lt;/tt&gt;,
     * &lt;tt&gt;codepointEnd&lt;/tt&gt; contains the inclusive end of the
     * iteration range, if &lt;tt&gt;codepoint != IS_STRING&lt;/tt&gt;.  If
     * iterating over code points using &lt;tt&gt;next()&lt;/tt&gt;, or if
     * &lt;tt&gt;codepoint == IS_STRING&lt;/tt&gt;, then the value of
     * &lt;tt&gt;codepointEnd&lt;/tt&gt; is undefined.
     */
    UChar32 codepointEnd;

    /**
     * If &lt;tt&gt;codepoint == IS_STRING&lt;/tt&gt;, then &lt;tt&gt;string&lt;/tt&gt; points
     * to the current string.  If &lt;tt&gt;codepoint != IS_STRING&lt;/tt&gt;, the
     * value of &lt;tt&gt;string&lt;/tt&gt; is undefined.
     */
    const UnicodeString* string;

 public:

    /**
     * Create an iterator over the given set.  The iterator is valid
     * only so long as &lt;tt&gt;set&lt;/tt&gt; is valid.
     * @param set set to iterate over
     * @stable ICU 2.4
     */
    UnicodeSetIterator(const UnicodeSet&amp; set);

    /**
     * Create an iterator over nothing.  &lt;tt&gt;next()&lt;/tt&gt; and
     * &lt;tt&gt;nextRange()&lt;/tt&gt; 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 &lt;tt&gt;getString()&lt;/tt&gt;.  If this
     * method returns false, the current element is a code point or
     * code point range, depending on whether &lt;tt&gt;next()&lt;/tt&gt; or
     * &lt;tt&gt;nextRange()&lt;/tt&gt; was called.
     * Elements of types string and codepoint can both be retrieved
     * with the function &lt;tt&gt;getString()&lt;/tt&gt;.
     * Elements of type codepoint can also be retrieved with
     * &lt;tt&gt;getCodepoint()&lt;/tt&gt;.
     * For ranges, &lt;tt&gt;getCodepoint()&lt;/tt&gt; returns the starting codepoint
     * of the range, and &lt;tt&gt;getCodepointEnd()&lt;/tt&gt; returns the end
     * of the range.
     * @stable ICU 2.4
     */
    inline UBool isString() const;

    /**
     * Returns the current code point, if &lt;tt&gt;isString()&lt;/tt&gt; returned
     * false.  Otherwise returns an undefined result.
     * @stable ICU 2.4
     */
    inline UChar32 getCodepoint() const;

    /**
     * Returns the end of the current code point range, if
     * &lt;tt&gt;isString()&lt;/tt&gt; returned false and &lt;tt&gt;nextRange()&lt;/tt&gt; was
     * called.  Otherwise returns an undefined result.
     * @stable ICU 2.4
     */
    inline UChar32 getCodepointEnd() const;

    /**
     * Returns the current string, if &lt;tt&gt;isString()&lt;/tt&gt; returned
     * true.  If the current iteration item is a code point, a UnicodeString
     * containing that single code point is returned.
     *
     * Ownership of the returned string remains with the iterator.
     * The string is guaranteed to remain valid only until the iterator is
     *   advanced to the next item, or until the iterator is deleted.
     * 
     * @stable ICU 2.4
     */
    const UnicodeString&amp; getString();

#ifndef U_HIDE_DRAFT_API
    /**
     * Skips over the remaining code points/ranges, if any.
     * A following call to next() or nextRange() will yield a string, if there is one.
     * No-op if next() would return false, or if it would yield a string anyway.
     *
     * @return *this
     * @draft ICU 70
     * @see UnicodeSet#strings()
     */
    inline UnicodeSetIterator &amp;skipToStrings() {
        // Finish code point/range iteration.
        range = endRange;
        endElement = -1;
        nextElement = 0;
        return *this;
    }
#endif  // U_HIDE_DRAFT_API

    /**
     * Advances the iteration position to the next element in the set, 
     * which can be either a single code point or a string.  
     * If there are no more elements in the set, return false.
     *
     * &lt;p&gt;
     * If &lt;tt&gt;isString() == true&lt;/tt&gt;, the value is a
     * string, otherwise the value is a
     * single code point.  Elements of either type can be retrieved
     * with the function &lt;tt&gt;getString()&lt;/tt&gt;, while elements of
     * consisting of a single code point can be retrieved with
     * &lt;tt&gt;getCodepoint()&lt;/tt&gt;
     *
     * &lt;p&gt;The order of iteration is all code points in sorted order,
     * followed by all strings sorted order.    Do not mix
     * calls to &lt;tt&gt;next()&lt;/tt&gt; and &lt;tt&gt;nextRange()&lt;/tt&gt; without
     * calling &lt;tt&gt;reset()&lt;/tt&gt; between them.  The results of doing so
     * are undefined.
     *
     * @return true if there was another element in the set.
     * @stable ICU 2.4
     */
    UBool next();

    /**
     * Returns the next element in the set, either a code point range
     * or a string.  If there are no more elements in the set, return
     * false.  If &lt;tt&gt;isString() == true&lt;/tt&gt;, the value is a
     * string and can be accessed with &lt;tt&gt;getString()&lt;/tt&gt;.  Otherwise the value is a
     * range of one or more code points from &lt;tt&gt;getCodepoint()&lt;/tt&gt; to
     * &lt;tt&gt;getCodepointeEnd()&lt;/tt&gt; inclusive.
     *
     * &lt;p&gt;The order of iteration is all code points ranges in sorted
     * order, followed by all strings sorted order.  Ranges are
     * disjoint and non-contiguous.  The value returned from &lt;tt&gt;getString()&lt;/tt&gt;
     * is undefined unless &lt;tt&gt;isString() == true&lt;/tt&gt;.  Do not mix calls to
     * &lt;tt&gt;next()&lt;/tt&gt; and &lt;tt&gt;nextRange()&lt;/tt&gt; without calling
     * &lt;tt&gt;reset()&lt;/tt&gt; between them.  The results of doing so are
     * undefined.
     *
     * @return true if there was another element in the set.
     * @stable ICU 2.4
     */
    UBool nextRange();

    /**
     * Sets this iterator to visit the elements of the given set and
     * resets it to the start of that set.  The iterator is valid only
     * so long as &lt;tt&gt;set&lt;/tt&gt; is valid.
     * @param set the set to iterate over.
     * @stable ICU 2.4
     */
    void reset(const UnicodeSet&amp; set);

    /**
     * Resets this iterator to the start of the set.
     * @stable ICU 2.4
     */
    void reset();

    /**
     * ICU &quot;poor man's RTTI&quot;, returns a UClassID for this class.
     *
     * @stable ICU 2.4
     */
    static UClassID U_EXPORT2 getStaticClassID();

    /**
     * ICU &quot;poor man's RTTI&quot;, returns a UClassID for the actual class.
     *
     * @stable ICU 2.4
     */
    virtual UClassID getDynamicClassID() const override;

    // ======================= PRIVATES ===========================

private:

    // endElement and nextElements are really UChar32's, but we keep
    // them as signed int32_t's so we can do comparisons with
    // endElement set to -1.  Leave them as int32_t's.
    /** The set
     */
    const UnicodeSet* set;
    /** End range
     */
    int32_t endRange;
    /** Range
     */
    int32_t range;
    /** End element
     */
    int32_t endElement;
    /** Next element
     */
    int32_t nextElement;
    /** Next string
     */
    int32_t nextString;
    /** String count
     */
    int32_t stringCount;

    /**
     *  Points to the string to use when the caller asks for a
     *  string and the current iteration item is a code point, not a string.
     */
    UnicodeString *cpString;

    /** Copy constructor. Disallowed.
     */
    UnicodeSetIterator(const UnicodeSetIterator&amp;) = delete;

    /** Assignment operator. Disallowed.
     */
    UnicodeSetIterator&amp; operator=(const UnicodeSetIterator&amp;) = delete;

    /** Load range
     */
    void loadRange(int32_t range);
};

inline UBool UnicodeSetIterator::isString() const {
    return codepoint &lt; 0;
}

inline UChar32 UnicodeSetIterator::getCodepoint() const {
    return codepoint;
}

inline UChar32 UnicodeSetIterator::getCodepointEnd() const {
    return codepointEnd;
}


U_NAMESPACE_END

#endif /* U_SHOW_CPLUSPLUS_API */

#endif
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Falt%2Flibicu71%2Fusr%2Finclude%2Funicode'>Back to Directory</a>