Lines Matching defs:Collator
40 * 11/02/99 helena Collator performance enhancements. Eliminates the
82 * The <code>Collator</code> class performs locale-sensitive string
92 * <code>Collator</code> is an abstract base class. Subclasses implement
100 * <code>Collator</code> object for a given locale. You will only need to
101 * look at the subclasses of <code>Collator</code> if you need to
106 * <code>Collator</code> for the default locale.
112 * Collator* myCollator = Collator::createInstance(success);
121 * You can set a <code>Collator</code>'s <em>strength</em> property to
133 * //Get the Collator for US English and set its strength to PRIMARY
135 * Collator* usCollator = Collator::createInstance(Locale::US, success);
136 * usCollator->setStrength(Collator::PRIMARY);
162 * <strong>Note:</strong> <code>Collator</code>s with different Locale,
177 class U_I18N_API Collator : public UObject {
180 // Collator public enums -----------------------------------------------
185 * Use this to set the strength of a Collator object.<br>
190 * differences. Use this to set the strength of a Collator object.<br>
195 * comparison differences. Use this to set the strength of a Collator
204 * generated from Collator objects.
223 * @see Collator#compare
233 // Collator public destructor -----------------------------------------
239 virtual ~Collator();
241 // Collator public methods --------------------------------------------
245 * @param other Collator object to be compared
249 virtual UBool operator==(const Collator& other) const;
253 * @param other Collator object to be compared
257 virtual UBool operator!=(const Collator& other) const;
264 virtual Collator* clone(void) const = 0;
267 * Creates the Collator object for the current default locale.
285 static Collator* U_EXPORT2 createInstance(UErrorCode& err);
302 * @param loc The locale ID for which to open a collator.
310 static Collator* U_EXPORT2 createInstance(const Locale& loc, UErrorCode& err);
314 * Create a Collator with a specific version.
318 * This is designed to be used to open the same collator for a given
326 * @param loc The locale ID for which to open a collator.
327 * @param version The requested collator version.
330 * @return A pointer to a Collator, or 0 if an error occurred
331 * or a collator with the requested version is not available.
336 static Collator *createInstance(const Locale &loc, UVersionInfo version, UErrorCode &err);
443 * Compares two strings using the Collator.
458 * Compares two UTF-8 strings using the Collator.
520 * Gets the locale of the Collator
526 * @return locale where the collation data lives. If the collator
539 * @see Collator#compare
551 * @see Collator#compare
563 * @see Collator#compare
575 * @see Collator#setStrength
586 * Collator*myCollation = Collator::createInstance(Locale::US, status);
588 * myCollation->setStrength(Collator::PRIMARY);
591 * Collator::ComparisonResult result = myCollation->compare("abc", "ABC");
594 * @see Collator#getStrength
614 * Set the ordering of scripts for this collator.
746 * Register a new Collator. The collator will be adopted.
747 * @param toAdopt the Collator instance to be adopted
748 * @param locale the locale with which the collator will be associated
750 * @return a registry key that can be used to unregister this collator
753 static URegistryKey U_EXPORT2 registerInstance(Collator* toAdopt, const Locale& locale, UErrorCode& status);
759 * @return a registry key that can be used to unregister this collator
765 * Unregister a previously-registered Collator or CollatorFactory
771 * @return TRUE if the collator for the key was successfully unregistered
778 * Gets the version information for a Collator.
851 * Gets the variable top value of a Collator.
860 * tailored in this collator.
875 virtual Collator* safeClone(void) = 0;
959 // Collator protected constructors -------------------------------------
963 * Constructor is different from the old default Collator constructor.
968 Collator();
981 Collator(UCollationStrength collationStrength,
986 * @param other Collator object to be copied from
989 Collator(const Collator& other);
991 // Collator protected methods -----------------------------------------
1016 Collator& operator=(const Collator& other);
1022 static Collator* makeInstance(const Locale& desiredLocale,
1025 // Collator private data members ---------------------------------------
1045 * If standard locale display names are sufficient, Collator instances can
1072 * Return a collator for the provided locale. If the locale
1074 * @param loc the locale identifying the collator to be created.
1075 * @return a new collator if the locale is supported, otherwise NULL.
1078 virtual Collator* createCollator(const Locale& loc) = 0;
1081 * Return the name of the collator for the objectLocale, localized for the displayLocale.
1084 * @param objectLocale the locale identifying the collator
1085 * @param displayLocale the locale for which the display name of the collator should be localized
1107 // Collator inline methods -----------------------------------------------
