- * Important: The ICU collation service has been reimplemented - * in order to achieve better performance and UCA compliance. - * For details, see the - * - * collation design document. *
- * RuleBasedCollator is a thin C++ wrapper over the C implementation. + * For more information about the collation service see + * the User Guide. *
- * For more information about the collation service see - * the users guide. - *
- * Collation service provides correct sorting orders for most locales supported in ICU. + * Collation service provides correct sorting orders for most locales supported in ICU. * If specific data for a locale is not available, the orders eventually falls back - * to the UCA sort order. + * to the CLDR root sort order. *
* Sort ordering may be customized by providing your own set of rules. For more on - * this subject see the - * Collation customization section of the users guide. + * this subject see the + * Collation Customization section of the User Guide. *
* Note, RuleBasedCollator is not to be subclassed. * @see Collator - * @version 2.0 11/15/2001 */ -class U_I18N_API RuleBasedCollator : public Collator -{ +class U_I18N_API RuleBasedCollator : public Collator { public: - - // constructor ------------------------------------------------------------- - /** * RuleBasedCollator constructor. This takes the table rules and builds a * collation table out of them. Please see RuleBasedCollator class * description for more details on the collation rule syntax. * @param rules the collation rules to build the collation table from. * @param status reporting a success or an error. - * @see Locale * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, UErrorCode& status); @@ -130,9 +128,8 @@ public: * collation table out of them. Please see RuleBasedCollator class * description for more details on the collation rule syntax. * @param rules the collation rules to build the collation table from. - * @param collationStrength default strength for comparison + * @param collationStrength strength for comparison * @param status reporting a success or an error. - * @see Locale * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, @@ -146,7 +143,6 @@ public: * @param rules the collation rules to build the collation table from. * @param decompositionMode the normalisation mode * @param status reporting a success or an error. - * @see Locale * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, @@ -158,10 +154,9 @@ public: * collation table out of them. Please see RuleBasedCollator class * description for more details on the collation rule syntax. * @param rules the collation rules to build the collation table from. - * @param collationStrength default strength for comparison + * @param collationStrength strength for comparison * @param decompositionMode the normalisation mode * @param status reporting a success or an error. - * @see Locale * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, @@ -169,36 +164,44 @@ public: UColAttributeValue decompositionMode, UErrorCode& status); +#ifndef U_HIDE_INTERNAL_API + /** + * TODO: document & propose as public API + * @internal + */ + RuleBasedCollator(const UnicodeString &rules, + UParseError &parseError, UnicodeString &reason, + UErrorCode &errorCode); +#endif /* U_HIDE_INTERNAL_API */ + /** * Copy constructor. * @param other the RuleBasedCollator object to be copied - * @see Locale * @stable ICU 2.0 */ RuleBasedCollator(const RuleBasedCollator& other); /** Opens a collator from a collator binary image created using - * cloneBinary. Binary image used in instantiation of the - * collator remains owned by the user and should stay around for + * cloneBinary. Binary image used in instantiation of the + * collator remains owned by the user and should stay around for * the lifetime of the collator. The API also takes a base collator - * which usualy should be UCA. + * which must be the root collator. * @param bin binary image owned by the user and required through the * lifetime of the collator * @param length size of the image. If negative, the API will try to * figure out the length of the image - * @param base fallback collator, usually UCA. Base is required to be - * present through the lifetime of the collator. Currently - * it cannot be NULL. + * @param base Base collator, for lookup of untailored characters. + * Must be the root collator, must not be NULL. + * The base is required to be present through the lifetime of the collator. * @param status for catching errors * @return newly created collator * @see cloneBinary * @stable ICU 3.4 */ - RuleBasedCollator(const uint8_t *bin, int32_t length, - const RuleBasedCollator *base, + RuleBasedCollator(const uint8_t *bin, int32_t length, + const RuleBasedCollator *base, UErrorCode &status); - // destructor -------------------------------------------------------------- /** * Destructor. @@ -206,11 +209,9 @@ public: */ virtual ~RuleBasedCollator(); - // public methods ---------------------------------------------------------- - /** * Assignment operator. - * @param other other RuleBasedCollator object to compare with. + * @param other other RuleBasedCollator object to copy from. * @stable ICU 2.0 */ RuleBasedCollator& operator=(const RuleBasedCollator& other); @@ -224,17 +225,8 @@ public: virtual UBool operator==(const Collator& other) const; /** - * Returns true if argument is not the same as this object. - * @param other Collator object to be compared - * @return returns true if argument is not the same as this object. - * @stable ICU 2.0 - */ - virtual UBool operator!=(const Collator& other) const; - - /** - * Makes a deep copy of the object. - * The caller owns the returned object. - * @return the cloned object. + * Makes a copy of this object. + * @return a copy of this object, owned by the caller * @stable ICU 2.0 */ virtual Collator* clone(void) const; @@ -264,25 +256,12 @@ public: virtual CollationElementIterator* createCollationElementIterator( const CharacterIterator& source) const; - /** - * Compares a range of character data stored in two different strings based - * on the collation rules. Returns information about whether a string is - * less than, greater than or equal to another string in a language. - * This can be overriden in a subclass. - * @param source the source string. - * @param target the target string to be compared with the source string. - * @return the comparison result. GREATER if the source string is greater - * than the target string, LESS if the source is less than the - * target. Otherwise, returns EQUAL. - * @deprecated ICU 2.6 Use overload with UErrorCode& - */ - virtual EComparisonResult compare(const UnicodeString& source, - const UnicodeString& target) const; - + // Make deprecated versions of Collator::compare() visible. + using Collator::compare; /** * The comparison function compares the character data stored in two - * different strings. Returns information about whether a string is less + * different strings. Returns information about whether a string is less * than, greater than or equal to another string. * @param source the source string to be compared with. * @param target the string that is to be compared with the source string. @@ -293,84 +272,30 @@ public: * @stable ICU 2.6 **/ virtual UCollationResult compare(const UnicodeString& source, - const UnicodeString& target, - UErrorCode &status) const; - - /** - * Compares a range of character data stored in two different strings based - * on the collation rules up to the specified length. Returns information - * about whether a string is less than, greater than or equal to another - * string in a language. This can be overriden in a subclass. - * @param source the source string. - * @param target the target string to be compared with the source string. - * @param length compares up to the specified length - * @return the comparison result. GREATER if the source string is greater - * than the target string, LESS if the source is less than the - * target. Otherwise, returns EQUAL. - * @deprecated ICU 2.6 Use overload with UErrorCode& - */ - virtual EComparisonResult compare(const UnicodeString& source, - const UnicodeString& target, - int32_t length) const; + const UnicodeString& target, + UErrorCode &status) const; /** - * Does the same thing as compare but limits the comparison to a specified + * Does the same thing as compare but limits the comparison to a specified * length * @param source the source string to be compared with. * @param target the string that is to be compared with the source string. * @param length the length the comparison is limited to * @param status possible error code - * @return Returns an enum value. UCOL_GREATER if source (up to the specified - * length) is greater than target; UCOL_EQUAL if source (up to specified - * length) is equal to target; UCOL_LESS if source (up to the specified + * @return Returns an enum value. UCOL_GREATER if source (up to the specified + * length) is greater than target; UCOL_EQUAL if source (up to specified + * length) is equal to target; UCOL_LESS if source (up to the specified * length) is less than target. * @stable ICU 2.6 */ virtual UCollationResult compare(const UnicodeString& source, - const UnicodeString& target, - int32_t length, - UErrorCode &status) const; - - /** - * The comparison function compares the character data stored in two - * different string arrays. Returns information about whether a string array - * is less than, greater than or equal to another string array. - *
Example of use: - *
- * . UChar ABC[] = {0x41, 0x42, 0x43, 0}; // = "ABC"
- * . UChar abc[] = {0x61, 0x62, 0x63, 0}; // = "abc"
- * . UErrorCode status = U_ZERO_ERROR;
- * . Collator *myCollation =
- * . Collator::createInstance(Locale::US, status);
- * . if (U_FAILURE(status)) return;
- * . myCollation->setStrength(Collator::PRIMARY);
- * . // result would be Collator::EQUAL ("abc" == "ABC")
- * . // (no primary difference between "abc" and "ABC")
- * . Collator::EComparisonResult result =
- * . myCollation->compare(abc, 3, ABC, 3);
- * . myCollation->setStrength(Collator::TERTIARY);
- * . // result would be Collator::LESS ("abc" <<< "ABC")
- * . // (with tertiary difference between "abc" and "ABC")
- * . result = myCollation->compare(abc, 3, ABC, 3);
- *
- * @param source the source string array to be compared with.
- * @param sourceLength the length of the source string array. If this value
- * is equal to -1, the string array is null-terminated.
- * @param target the string that is to be compared with the source string.
- * @param targetLength the length of the target string array. If this value
- * is equal to -1, the string array is null-terminated.
- * @return Returns a byte value. GREATER if source is greater than target;
- * EQUAL if source is equal to target; LESS if source is less than
- * target
- * @deprecated ICU 2.6 Use overload with UErrorCode&
- */
- virtual EComparisonResult compare(const UChar* source, int32_t sourceLength,
- const UChar* target, int32_t targetLength)
- const;
+ const UnicodeString& target,
+ int32_t length,
+ UErrorCode &status) const;
/**
* The comparison function compares the character data stored in two
- * different string arrays. Returns information about whether a string array
+ * different string arrays. Returns information about whether a string array
* is less than, greater than or equal to another string array.
* @param source the source string array to be compared with.
* @param sourceLength the length of the source string array. If this value
@@ -384,9 +309,9 @@ public:
* than target
* @stable ICU 2.6
*/
- virtual UCollationResult compare(const UChar* source, int32_t sourceLength,
- const UChar* target, int32_t targetLength,
- UErrorCode &status) const;
+ virtual UCollationResult compare(const char16_t* source, int32_t sourceLength,
+ const char16_t* target, int32_t targetLength,
+ UErrorCode &status) const;
/**
* Compares two strings using the Collator.
@@ -404,35 +329,56 @@ public:
UErrorCode &status) const;
/**
- * Transforms a specified region of the string into a series of characters
- * that can be compared with CollationKey.compare. Use a CollationKey when
- * you need to do repeated comparisions on the same string. For a single
- * comparison the compare method will be faster.
- * @param source the source string.
- * @param key the transformed key of the source string.
- * @param status the error code status.
- * @return the transformed key.
- * @see CollationKey
- * @deprecated ICU 2.8 Use getSortKey(...) instead
- */
+ * Compares two UTF-8 strings using the Collator.
+ * Returns whether the first one compares less than/equal to/greater than
+ * the second one.
+ * This version takes UTF-8 input.
+ * Note that a StringPiece can be implicitly constructed
+ * from a std::string or a NUL-terminated const char * string.
+ * @param source the first UTF-8 string
+ * @param target the second UTF-8 string
+ * @param status ICU status
+ * @return UCOL_LESS, UCOL_EQUAL or UCOL_GREATER
+ * @stable ICU 51
+ */
+ virtual UCollationResult compareUTF8(const StringPiece &source,
+ const StringPiece &target,
+ UErrorCode &status) const;
+
+ /**
+ * Transforms the string into a series of characters
+ * that can be compared with CollationKey.compare().
+ *
+ * Note that sort keys are often less efficient than simply doing comparison.
+ * For more details, see the ICU User Guide.
+ *
+ * @param source the source string.
+ * @param key the transformed key of the source string.
+ * @param status the error code status.
+ * @return the transformed key.
+ * @see CollationKey
+ * @stable ICU 2.0
+ */
virtual CollationKey& getCollationKey(const UnicodeString& source,
CollationKey& key,
UErrorCode& status) const;
/**
- * Transforms a specified region of the string into a series of characters
- * that can be compared with CollationKey.compare. Use a CollationKey when
- * you need to do repeated comparisions on the same string. For a single
- * comparison the compare method will be faster.
- * @param source the source string.
- * @param sourceLength the length of the source string.
- * @param key the transformed key of the source string.
- * @param status the error code status.
- * @return the transformed key.
- * @see CollationKey
- * @deprecated ICU 2.8 Use getSortKey(...) instead
- */
- virtual CollationKey& getCollationKey(const UChar *source,
+ * Transforms a specified region of the string into a series of characters
+ * that can be compared with CollationKey.compare.
+ *
+ * Note that sort keys are often less efficient than simply doing comparison.
+ * For more details, see the ICU User Guide.
+ *
+ * @param source the source string.
+ * @param sourceLength the length of the source string.
+ * @param key the transformed key of the source string.
+ * @param status the error code status.
+ * @return the transformed key.
+ * @see CollationKey
+ * @stable ICU 2.0
+ */
+ virtual CollationKey& getCollationKey(const char16_t *source,
int32_t sourceLength,
CollationKey& key,
UErrorCode& status) const;
@@ -442,7 +388,7 @@ public:
* @return the hash code.
* @stable ICU 2.0
*/
- virtual int32_t hashCode(void) const;
+ virtual int32_t hashCode() const;
/**
* Gets the locale of the Collator
@@ -454,15 +400,14 @@ public:
* was instantiated from rules, locale is empty.
* @deprecated ICU 2.8 likely to change in ICU 3.0, based on feedback
*/
- virtual const Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;
+ virtual Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;
/**
- * Gets the table-based rules for the collation object.
- * @return returns the collation rules that the table collation object was
- * created from.
+ * Gets the tailoring rules for this collator.
+ * @return the collation tailoring from which this collator was created
* @stable ICU 2.0
*/
- const UnicodeString& getRules(void) const;
+ const UnicodeString& getRules() const;
/**
* Gets the version information for a Collator.
@@ -471,17 +416,25 @@ public:
*/
virtual void getVersion(UVersionInfo info) const;
+#ifndef U_HIDE_DEPRECATED_API
/**
- * Return the maximum length of any expansion sequences that end with the
+ * Returns the maximum length of any expansion sequences that end with the
* specified comparison order.
- * @param order a collation order returned by previous or next.
+ *
+ * This is specific to the kind of collation element values and sequences
+ * returned by the CollationElementIterator.
+ * Call CollationElementIterator::getMaxExpansion() instead.
+ *
+ * @param order a collation order returned by CollationElementIterator::previous
+ * or CollationElementIterator::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
+ * element, or 1 if the collation element does not occur at the end of
* any expansion sequence
* @see CollationElementIterator#getMaxExpansion
- * @stable ICU 2.0
+ * @deprecated ICU 51 Use CollationElementIterator::getMaxExpansion() instead.
*/
int32_t getMaxExpansion(int32_t order) const;
+#endif /* U_HIDE_DEPRECATED_API */
/**
* Returns a unique class ID POLYMORPHICALLY. Pure virtual override. This
@@ -508,18 +461,21 @@ public:
*/
static UClassID U_EXPORT2 getStaticClassID(void);
+#ifndef U_HIDE_DEPRECATED_API
/**
- * Returns the binary format of the class's rules. The format is that of
- * .col files.
+ * Do not use this method: The caller and the ICU library might use different heaps.
+ * Use cloneBinary() instead which writes to caller-provided memory.
+ *
+ * Returns a binary format of this collator.
* @param length Returns the length of the data, in bytes
* @param status the error code status.
* @return memory, owned by the caller, of size 'length' bytes.
- * @stable ICU 2.2
+ * @deprecated ICU 52. Use cloneBinary() instead.
*/
- uint8_t *cloneRuleData(int32_t &length, UErrorCode &status);
-
+ uint8_t *cloneRuleData(int32_t &length, UErrorCode &status) const;
+#endif /* U_HIDE_DEPRECATED_API */
- /** Creates a binary image of a collator. This binary image can be stored and
+ /** Creates a binary image of a collator. This binary image can be stored and
* later used to instantiate a collator using ucol_openBinary.
* This API supports preflighting.
* @param buffer a fill-in buffer to receive the binary image
@@ -529,16 +485,20 @@ public:
* @see ucol_openBinary
* @stable ICU 3.4
*/
- int32_t cloneBinary(uint8_t *buffer, int32_t capacity, UErrorCode &status);
+ int32_t cloneBinary(uint8_t *buffer, int32_t capacity, UErrorCode &status) const;
/**
* Returns current rules. Delta defines whether full rules are returned or
* just the tailoring.
+ *
+ * getRules(void) should normally be used instead.
+ * See http://userguide.icu-project.org/collation/customization#TOC-Building-on-Existing-Locales
* @param delta one of UCOL_TAILORING_ONLY, UCOL_FULL_RULES.
* @param buffer UnicodeString to store the result rules
* @stable ICU 2.2
+ * @see UCOL_FULL_RULES
*/
- void getRules(UColRuleOption delta, UnicodeString &buffer);
+ void getRules(UColRuleOption delta, UnicodeString &buffer) const;
/**
* Universal attribute setter
@@ -558,68 +518,108 @@ public:
* @stable ICU 2.2
*/
virtual UColAttributeValue getAttribute(UColAttribute attr,
- UErrorCode &status);
+ UErrorCode &status) const;
+
+ /**
+ * Sets the variable top to the top of the specified reordering group.
+ * The variable top determines the highest-sorting character
+ * which is affected by UCOL_ALTERNATE_HANDLING.
+ * If that attribute is set to UCOL_NON_IGNORABLE, then the variable top has no effect.
+ * @param group one of UCOL_REORDER_CODE_SPACE, UCOL_REORDER_CODE_PUNCTUATION,
+ * UCOL_REORDER_CODE_SYMBOL, UCOL_REORDER_CODE_CURRENCY;
+ * or UCOL_REORDER_CODE_DEFAULT to restore the default max variable group
+ * @param errorCode Standard ICU error code. Its input value must
+ * pass the U_SUCCESS() test, or else the function returns
+ * immediately. Check for U_FAILURE() on output or use with
+ * function chaining. (See User Guide for details.)
+ * @return *this
+ * @see getMaxVariable
+ * @stable ICU 53
+ */
+ virtual Collator &setMaxVariable(UColReorderCode group, UErrorCode &errorCode);
+
+ /**
+ * Returns the maximum reordering group whose characters are affected by UCOL_ALTERNATE_HANDLING.
+ * @return the maximum variable reordering group.
+ * @see setMaxVariable
+ * @stable ICU 53
+ */
+ virtual UColReorderCode getMaxVariable() const;
/**
- * Sets the variable top to a collation element value of a string supplied.
- * @param varTop one or more (if contraction) UChars to which the variable top should be set
+ * Sets the variable top to the primary weight of the specified string.
+ *
+ * Beginning with ICU 53, the variable top is pinned to
+ * the top of one of the supported reordering groups,
+ * and it must not be beyond the last of those groups.
+ * See setMaxVariable().
+ * @param varTop one or more (if contraction) char16_ts to which the variable top should be set
* @param len length of variable top string. If -1 it is considered to be zero terminated.
* @param status error code. If error code is set, the return value is undefined. Errors set by this function are: E.g. with strength == SECONDARY, the tertiary difference is ignored - *
E.g. with strength == PRIMARY, the secondary and tertiary difference
- * are ignored.
- * @return the current comparison level.
- * @see RuleBasedCollator#setStrength
- * @deprecated ICU 2.6 Use getAttribute(UCOL_STRENGTH...) instead
- */
- virtual ECollationStrength getStrength(void) const;
-
- /**
- * Sets the minimum strength to be used in comparison or transformation.
- * @see RuleBasedCollator#getStrength
- * @param newStrength the new comparison level.
- * @deprecated ICU 2.6 Use setAttribute(UCOL_STRENGTH...) instead
- */
- virtual void setStrength(ECollationStrength newStrength);
-
- /**
- * Get the current reordering of scripts (if one has been set).
+ * Retrieves the reordering codes for this collator.
* @param dest The array to fill with the script ordering.
- * @param destCapacity The length of dest. If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting).
- * @param pErrorCode Must be a valid pointer to an error code value, which must not indicate a failure before the function call.
- * @return The length of the array of the script ordering.
- * @see ucol_getReorderCodes
- * @internal
+ * @param destCapacity The length of dest. If it is 0, then dest may be NULL and the function
+ * will only return the length of the result without writing any codes (pre-flighting).
+ * @param status A reference to an error code value, which must not indicate
+ * a failure before the function call.
+ * @return The length of the script ordering array.
+ * @see ucol_setReorderCodes
+ * @see Collator#getEquivalentReorderCodes
+ * @see Collator#setReorderCodes
+ * @stable ICU 4.8
*/
- virtual int32_t getReorderCodes(int32_t* dest,
- int32_t destCapacity,
- UErrorCode& status) const;
+ virtual int32_t getReorderCodes(int32_t *dest,
+ int32_t destCapacity,
+ UErrorCode& status) const;
/**
- * Set the ordering of scripts for this collator.
- * @param reorderCodes An array of script codes in the new order.
+ * Sets the ordering of scripts for this collator.
+ * @param reorderCodes An array of script codes in the new order. This can be NULL if the
+ * length is also set to 0. An empty array will clear any reordering codes on the collator.
* @param reorderCodesLength The length of reorderCodes.
+ * @param status error code
* @see ucol_setReorderCodes
- * @internal
+ * @see Collator#getReorderCodes
+ * @see Collator#getEquivalentReorderCodes
+ * @stable ICU 4.8
+ */
+ virtual void setReorderCodes(const int32_t* reorderCodes,
+ int32_t reorderCodesLength,
+ UErrorCode& status) ;
+
+ /**
+ * Implements ucol_strcollUTF8().
+ * @internal
+ */
+ virtual UCollationResult internalCompareUTF8(
+ const char *left, int32_t leftLength,
+ const char *right, int32_t rightLength,
+ UErrorCode &errorCode) const;
+
+ /** Get the short definition string for a collator. This internal API harvests the collator's
+ * locale and the attribute set and produces a string that can be used for opening
+ * a collator with the same attributes using the ucol_openFromShortString API.
+ * This string will be normalized.
+ * The structure and the syntax of the string is defined in the "Naming collators"
+ * section of the users guide:
+ * http://userguide.icu-project.org/collation/concepts#TOC-Collator-naming-scheme
+ * This function supports preflighting.
+ *
+ * This is internal, and intended to be used with delegate converters.
+ *
+ * @param locale a locale that will appear as a collators locale in the resulting
+ * short string definition. If NULL, the locale will be harvested
+ * from the collator.
+ * @param buffer space to hold the resulting string
+ * @param capacity capacity of the buffer
+ * @param status for returning errors. All the preflighting errors are featured
+ * @return length of the resulting string
+ * @see ucol_openFromShortString
+ * @see ucol_normalizeShortDefinitionString
+ * @see ucol_getShortDefinitionString
+ * @internal
*/
- virtual void setReorderCodes(const int32_t* reorderCodes,
- int32_t reorderCodesLength,
- UErrorCode& status);
-
-
-private:
-
- // private static constants -----------------------------------------------
-
- enum {
- /* need look up in .commit() */
- CHARINDEX = 0x70000000,
- /* Expand index follows */
- EXPANDCHARINDEX = 0x7E000000,
- /* contract indexes follows */
- CONTRACTCHARINDEX = 0x7F000000,
- /* unmapped character values */
- UNMAPPED = 0xFFFFFFFF,
- /* primary strength increment */
- PRIMARYORDERINCREMENT = 0x00010000,
- /* secondary strength increment */
- SECONDARYORDERINCREMENT = 0x00000100,
- /* tertiary strength increment */
- TERTIARYORDERINCREMENT = 0x00000001,
- /* mask off anything but primary order */
- PRIMARYORDERMASK = 0xffff0000,
- /* mask off anything but secondary order */
- SECONDARYORDERMASK = 0x0000ff00,
- /* mask off anything but tertiary order */
- TERTIARYORDERMASK = 0x000000ff,
- /* mask off ignorable char order */
- IGNORABLEMASK = 0x0000ffff,
- /* use only the primary difference */
- PRIMARYDIFFERENCEONLY = 0xffff0000,
- /* use only the primary and secondary difference */
- SECONDARYDIFFERENCEONLY = 0xffffff00,
- /* primary order shift */
- PRIMARYORDERSHIFT = 16,
- /* secondary order shift */
- SECONDARYORDERSHIFT = 8,
- /* starting value for collation elements */
- COLELEMENTSTART = 0x02020202,
- /* testing mask for primary low element */
- PRIMARYLOWZEROMASK = 0x00FF0000,
- /* reseting value for secondaries and tertiaries */
- RESETSECONDARYTERTIARY = 0x00000202,
- /* reseting value for tertiaries */
- RESETTERTIARY = 0x00000002,
-
- PRIMIGNORABLE = 0x0202
- };
-
- // private data members ---------------------------------------------------
-
- UBool dataIsOwned;
-
- UBool isWriteThroughAlias;
-
- /**
- * c struct for collation. All initialisation for it has to be done through
- * setUCollator().
- */
- UCollator *ucollator;
-
- /**
- * Rule UnicodeString
- */
- UnicodeString urulestring;
-
- // friend classes --------------------------------------------------------
+ virtual int32_t internalGetShortDefinitionString(const char *locale,
+ char *buffer,
+ int32_t capacity,
+ UErrorCode &status) const;
/**
- * Used to iterate over collation elements in a character source.
- */
- friend class CollationElementIterator;
-
- /**
- * Collator ONLY needs access to RuleBasedCollator(const Locale&,
- * UErrorCode&)
- */
- friend class Collator;
-
- /**
- * Searching over collation elements in a character source
- */
- friend class StringSearch;
-
- // private constructors --------------------------------------------------
+ * Implements ucol_nextSortKeyPart().
+ * @internal
+ */
+ virtual int32_t internalNextSortKeyPart(
+ UCharIterator *iter, uint32_t state[2],
+ uint8_t *dest, int32_t count, UErrorCode &errorCode) const;
+ // Do not enclose the default constructor with #ifndef U_HIDE_INTERNAL_API
/**
- * Default constructor
+ * Only for use in ucol_openRules().
+ * @internal
*/
RuleBasedCollator();
+#ifndef U_HIDE_INTERNAL_API
/**
- * RuleBasedCollator constructor. This constructor takes a locale. The
- * only caller of this class should be Collator::createInstance(). If
- * createInstance() happens to know that the requested locale's collation is
- * implemented as a RuleBasedCollator, it can then call this constructor.
- * OTHERWISE IT SHOULDN'T, since this constructor ALWAYS RETURNS A VALID
- * COLLATION TABLE. It does this by falling back to defaults.
- * @param desiredLocale locale used
- * @param status error code status
+ * Implements ucol_getLocaleByType().
+ * Needed because the lifetime of the locale ID string must match that of the collator.
+ * getLocale() returns a copy of a Locale, with minimal lifetime in a C wrapper.
+ * @internal
*/
- RuleBasedCollator(const Locale& desiredLocale, UErrorCode& status);
+ const char *internalGetLocaleID(ULocDataLocaleType type, UErrorCode &errorCode) const;
/**
- * common constructor implementation
- *
- * @param rules the collation rules to build the collation table from.
- * @param collationStrength default strength for comparison
- * @param decompositionMode the normalisation mode
- * @param status reporting a success or an error.
+ * Implements ucol_getContractionsAndExpansions().
+ * Gets this collator's sets of contraction strings and/or
+ * characters and strings that map to multiple collation elements (expansions).
+ * If addPrefixes is TRUE, then contractions that are expressed as
+ * prefix/pre-context rules are included.
+ * @param contractions if not NULL, the set to hold the contractions
+ * @param expansions if not NULL, the set to hold the expansions
+ * @param addPrefixes include prefix contextual mappings
+ * @param errorCode in/out ICU error code
+ * @internal
*/
- void
- construct(const UnicodeString& rules,
- UColAttributeValue collationStrength,
- UColAttributeValue decompositionMode,
- UErrorCode& status);
-
- // private methods -------------------------------------------------------
+ void internalGetContractionsAndExpansions(
+ UnicodeSet *contractions, UnicodeSet *expansions,
+ UBool addPrefixes, UErrorCode &errorCode) const;
/**
- * Creates the c struct for ucollator
- * @param locale desired locale
- * @param status error status
- */
- void setUCollator(const Locale& locale, UErrorCode& status);
+ * Adds the contractions that start with character c to the set.
+ * Ignores prefixes. Used by AlphabeticIndex.
+ * @internal
+ */
+ void internalAddContractions(UChar32 c, UnicodeSet &set, UErrorCode &errorCode) const;
/**
- * Creates the c struct for ucollator
- * @param locale desired locale name
- * @param status error status
- */
- void setUCollator(const char* locale, UErrorCode& status);
+ * Implements from-rule constructors, and ucol_openRules().
+ * @internal
+ */
+ void internalBuildTailoring(
+ const UnicodeString &rules,
+ int32_t strength,
+ UColAttributeValue decompositionMode,
+ UParseError *outParseError, UnicodeString *outReason,
+ UErrorCode &errorCode);
- /**
- * Creates the c struct for ucollator. This used internally by StringSearch.
- * Hence the responsibility of cleaning up the ucollator is not done by
- * this RuleBasedCollator. The isDataOwned flag is set to FALSE.
- * @param collator new ucollator data
- * @param rules corresponding collation rules
- */
- void setUCollator(UCollator *collator);
+ /** @internal */
+ static inline RuleBasedCollator *rbcFromUCollator(UCollator *uc) {
+ return dynamic_cast