Index: public/i18n/unicode/coleitr.h |
diff --git a/public/i18n/unicode/coleitr.h b/public/i18n/unicode/coleitr.h |
deleted file mode 100644 |
index 4025a41d730997c2f00e37475881abfda4fb6ec8..0000000000000000000000000000000000000000 |
--- a/public/i18n/unicode/coleitr.h |
+++ /dev/null |
@@ -1,400 +0,0 @@ |
-/* |
- ****************************************************************************** |
- * Copyright (C) 1997-2008, International Business Machines |
- * Corporation and others. All Rights Reserved. |
- ****************************************************************************** |
- */ |
- |
-/** |
- * \file |
- * \brief C++ API: Collation Element Iterator. |
- */ |
- |
-/** |
-* File coleitr.h |
-* |
-* |
-* |
-* Created by: Helena Shih |
-* |
-* Modification History: |
-* |
-* Date Name Description |
-* |
-* 8/18/97 helena Added internal API documentation. |
-* 08/03/98 erm Synched with 1.2 version CollationElementIterator.java |
-* 12/10/99 aliu Ported Thai collation support from Java. |
-* 01/25/01 swquek Modified into a C++ wrapper calling C APIs (ucoliter.h) |
-* 02/19/01 swquek Removed CollationElementsIterator() since it is |
-* private constructor and no calls are made to it |
-*/ |
- |
-#ifndef COLEITR_H |
-#define COLEITR_H |
- |
-#include "unicode/utypes.h" |
- |
- |
-#if !UCONFIG_NO_COLLATION |
- |
-#include "unicode/uobject.h" |
-#include "unicode/tblcoll.h" |
-#include "unicode/ucoleitr.h" |
- |
-/** |
- * The UCollationElements struct. |
- * For usage in C programs. |
- * @stable ICU 2.0 |
- */ |
-typedef struct UCollationElements UCollationElements; |
- |
-U_NAMESPACE_BEGIN |
- |
-/** |
-* The CollationElementIterator class is used as an iterator to walk through |
-* each character of an international string. Use the iterator to return the |
-* ordering priority of the positioned character. The ordering priority of a |
-* character, which we refer to as a key, defines how a character is collated in |
-* the given collation object. |
-* For example, consider the following in Spanish: |
-* <pre> |
-* "ca" -> the first key is key('c') and second key is key('a'). |
-* "cha" -> the first key is key('ch') and second key is key('a').</pre> |
-* And in German, |
-* <pre> \htmlonly "æb"-> the first key is key('a'), the second key is key('e'), and |
-* the third key is key('b'). \endhtmlonly </pre> |
-* The key of a character, is an integer composed of primary order(short), |
-* secondary order(char), and tertiary order(char). Java strictly defines the |
-* size and signedness of its primitive data types. Therefore, the static |
-* functions primaryOrder(), secondaryOrder(), and tertiaryOrder() return |
-* int32_t to ensure the correctness of the key value. |
-* <p>Example of the iterator usage: (without error checking) |
-* <pre> |
-* \code |
-* void CollationElementIterator_Example() |
-* { |
-* UnicodeString str = "This is a test"; |
-* UErrorCode success = U_ZERO_ERROR; |
-* RuleBasedCollator* rbc = |
-* (RuleBasedCollator*) RuleBasedCollator::createInstance(success); |
-* CollationElementIterator* c = |
-* rbc->createCollationElementIterator( str ); |
-* int32_t order = c->next(success); |
-* c->reset(); |
-* order = c->previous(success); |
-* delete c; |
-* delete rbc; |
-* } |
-* \endcode |
-* </pre> |
-* <p> |
-* CollationElementIterator::next returns the collation order of the next |
-* character based on the comparison level of the collator. |
-* CollationElementIterator::previous returns the collation order of the |
-* previous character based on the comparison level of the collator. |
-* The Collation Element Iterator moves only in one direction between calls to |
-* CollationElementIterator::reset. That is, CollationElementIterator::next() |
-* and CollationElementIterator::previous can not be inter-used. Whenever |
-* CollationElementIterator::previous is to be called after |
-* CollationElementIterator::next() or vice versa, |
-* CollationElementIterator::reset has to be called first to reset the status, |
-* shifting pointers to either the end or the start of the string. Hence at the |
-* next call of CollationElementIterator::previous or |
-* CollationElementIterator::next(), the first or last collation order will be |
-* returned. |
-* If a change of direction is done without a CollationElementIterator::reset(), |
-* the result is undefined. |
-* The result of a forward iterate (CollationElementIterator::next) and |
-* reversed result of the backward iterate (CollationElementIterator::previous) |
-* on the same string are equivalent, if collation orders with the value |
-* UCOL_IGNORABLE are ignored. |
-* Character based on the comparison level of the collator. A collation order |
-* consists of primary order, secondary order and tertiary order. The data |
-* type of the collation order is <strong>t_int32</strong>. |
-* |
-* Note, CollationElementIterator should not be subclassed. |
-* @see Collator |
-* @see RuleBasedCollator |
-* @version 1.8 Jan 16 2001 |
-*/ |
-class U_I18N_API CollationElementIterator : public UObject { |
-public: |
- |
- // CollationElementIterator public data member ------------------------------ |
- |
- enum { |
- /** |
- * NULLORDER indicates that an error has occured while processing |
- * @stable ICU 2.0 |
- */ |
- NULLORDER = (int32_t)0xffffffff |
- }; |
- |
- // CollationElementIterator public constructor/destructor ------------------- |
- |
- /** |
- * Copy constructor. |
- * |
- * @param other the object to be copied from |
- * @stable ICU 2.0 |
- */ |
- CollationElementIterator(const CollationElementIterator& other); |
- |
- /** |
- * Destructor |
- * @stable ICU 2.0 |
- */ |
- virtual ~CollationElementIterator(); |
- |
- // CollationElementIterator public methods ---------------------------------- |
- |
- /** |
- * Returns true if "other" is the same as "this" |
- * |
- * @param other the object to be compared |
- * @return true if "other" is the same as "this" |
- * @stable ICU 2.0 |
- */ |
- UBool operator==(const CollationElementIterator& other) const; |
- |
- /** |
- * Returns true if "other" is not the same as "this". |
- * |
- * @param other the object to be compared |
- * @return true if "other" is not the same as "this" |
- * @stable ICU 2.0 |
- */ |
- UBool operator!=(const CollationElementIterator& other) const; |
- |
- /** |
- * Resets the cursor to the beginning of the string. |
- * @stable ICU 2.0 |
- */ |
- void reset(void); |
- |
- /** |
- * Gets the ordering priority of the next character in the string. |
- * @param status the error code status. |
- * @return the next character's ordering. otherwise returns NULLORDER if an |
- * error has occured or if the end of string has been reached |
- * @stable ICU 2.0 |
- */ |
- int32_t next(UErrorCode& status); |
- |
- /** |
- * Get the ordering priority of the previous collation element in the string. |
- * @param status the error code status. |
- * @return the previous element's ordering. otherwise returns NULLORDER if an |
- * error has occured or if the start of string has been reached |
- * @stable ICU 2.0 |
- */ |
- int32_t previous(UErrorCode& status); |
- |
- /** |
- * Gets the primary order of a collation order. |
- * @param order the collation order |
- * @return the primary order of a collation order. |
- * @stable ICU 2.0 |
- */ |
- static inline int32_t primaryOrder(int32_t order); |
- |
- /** |
- * Gets the secondary order of a collation order. |
- * @param order the collation order |
- * @return the secondary order of a collation order. |
- * @stable ICU 2.0 |
- */ |
- static inline int32_t secondaryOrder(int32_t order); |
- |
- /** |
- * Gets the tertiary order of a collation order. |
- * @param order the collation order |
- * @return the tertiary order of a collation order. |
- * @stable ICU 2.0 |
- */ |
- static inline int32_t tertiaryOrder(int32_t order); |
- |
- /** |
- * Return the maximum length of any expansion sequences that end with the |
- * specified comparison order. |
- * @param order a collation order returned by previous or next. |
- * @return maximum size of the expansion sequences ending with the collation |
- * element or 1 if collation element does not occur at the end of any |
- * expansion sequence |
- * @stable ICU 2.0 |
- */ |
- int32_t getMaxExpansion(int32_t order) const; |
- |
- /** |
- * Gets the comparison order in the desired strength. Ignore the other |
- * differences. |
- * @param order The order value |
- * @stable ICU 2.0 |
- */ |
- int32_t strengthOrder(int32_t order) const; |
- |
- /** |
- * Sets the source string. |
- * @param str the source string. |
- * @param status the error code status. |
- * @stable ICU 2.0 |
- */ |
- void setText(const UnicodeString& str, UErrorCode& status); |
- |
- /** |
- * Sets the source string. |
- * @param str the source character iterator. |
- * @param status the error code status. |
- * @stable ICU 2.0 |
- */ |
- void setText(CharacterIterator& str, UErrorCode& status); |
- |
- /** |
- * Checks if a comparison order is ignorable. |
- * @param order the collation order. |
- * @return TRUE if a character is ignorable, FALSE otherwise. |
- * @stable ICU 2.0 |
- */ |
- static inline UBool isIgnorable(int32_t order); |
- |
- /** |
- * Gets the offset of the currently processed character in the source string. |
- * @return the offset of the character. |
- * @stable ICU 2.0 |
- */ |
- int32_t getOffset(void) const; |
- |
- /** |
- * Sets the offset of the currently processed character in the source string. |
- * @param newOffset the new offset. |
- * @param status the error code status. |
- * @return the offset of the character. |
- * @stable ICU 2.0 |
- */ |
- void setOffset(int32_t newOffset, UErrorCode& status); |
- |
- /** |
- * ICU "poor man's RTTI", returns a UClassID for the actual class. |
- * |
- * @stable ICU 2.2 |
- */ |
- virtual UClassID getDynamicClassID() const; |
- |
- /** |
- * ICU "poor man's RTTI", returns a UClassID for this class. |
- * |
- * @stable ICU 2.2 |
- */ |
- static UClassID U_EXPORT2 getStaticClassID(); |
- |
-protected: |
- |
- // CollationElementIterator protected constructors -------------------------- |
- /** |
- * @stable ICU 2.0 |
- */ |
- friend class RuleBasedCollator; |
- |
- /** |
- * CollationElementIterator constructor. This takes the source string and the |
- * collation object. The cursor will walk thru the source string based on the |
- * predefined collation rules. If the source string is empty, NULLORDER will |
- * be returned on the calls to next(). |
- * @param sourceText the source string. |
- * @param order the collation object. |
- * @param status the error code status. |
- * @stable ICU 2.0 |
- */ |
- CollationElementIterator(const UnicodeString& sourceText, |
- const RuleBasedCollator* order, UErrorCode& status); |
- |
- /** |
- * CollationElementIterator constructor. This takes the source string and the |
- * collation object. The cursor will walk thru the source string based on the |
- * predefined collation rules. If the source string is empty, NULLORDER will |
- * be returned on the calls to next(). |
- * @param sourceText the source string. |
- * @param order the collation object. |
- * @param status the error code status. |
- * @stable ICU 2.0 |
- */ |
- CollationElementIterator(const CharacterIterator& sourceText, |
- const RuleBasedCollator* order, UErrorCode& status); |
- |
- // CollationElementIterator protected methods ------------------------------- |
- |
- /** |
- * Assignment operator |
- * |
- * @param other the object to be copied |
- * @stable ICU 2.0 |
- */ |
- const CollationElementIterator& |
- operator=(const CollationElementIterator& other); |
- |
-private: |
- CollationElementIterator(); // default constructor not implemented |
- |
- // CollationElementIterator private data members ---------------------------- |
- |
- /** |
- * Data wrapper for collation elements |
- */ |
- UCollationElements *m_data_; |
- |
- /** |
- * Indicates if m_data_ belongs to this object. |
- */ |
- UBool isDataOwned_; |
- |
-}; |
- |
-// CollationElementIterator inline method defination -------------------------- |
- |
-/** |
-* Get the primary order of a collation order. |
-* @param order the collation order |
-* @return the primary order of a collation order. |
-*/ |
-inline int32_t CollationElementIterator::primaryOrder(int32_t order) |
-{ |
- order &= RuleBasedCollator::PRIMARYORDERMASK; |
- return (order >> RuleBasedCollator::PRIMARYORDERSHIFT); |
-} |
- |
-/** |
-* Get the secondary order of a collation order. |
-* @param order the collation order |
-* @return the secondary order of a collation order. |
-*/ |
-inline int32_t CollationElementIterator::secondaryOrder(int32_t order) |
-{ |
- order = order & RuleBasedCollator::SECONDARYORDERMASK; |
- return (order >> RuleBasedCollator::SECONDARYORDERSHIFT); |
-} |
- |
-/** |
-* Get the tertiary order of a collation order. |
-* @param order the collation order |
-* @return the tertiary order of a collation order. |
-*/ |
-inline int32_t CollationElementIterator::tertiaryOrder(int32_t order) |
-{ |
- return (order &= RuleBasedCollator::TERTIARYORDERMASK); |
-} |
- |
-inline int32_t CollationElementIterator::getMaxExpansion(int32_t order) const |
-{ |
- return ucol_getMaxExpansion(m_data_, (uint32_t)order); |
-} |
- |
-inline UBool CollationElementIterator::isIgnorable(int32_t order) |
-{ |
- return (primaryOrder(order) == RuleBasedCollator::PRIMIGNORABLE); |
-} |
- |
-U_NAMESPACE_END |
- |
-#endif /* #if !UCONFIG_NO_COLLATION */ |
- |
-#endif |