Collator Classe

Définition

Espace de noms:: Android.Icu.Text

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

[icu enhancement] ICU remplacement de l’ICU pour java.text.Collator.

[Android.Runtime.Register("android/icu/text/Collator", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class Collator : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.Util.IComparator

[<Android.Runtime.Register("android/icu/text/Collator", ApiSince=24, DoNotGenerateAcw=true)>]
type Collator = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparator

Héritage: Object

JavaObject

Object
Collator

Dérivé: Android.Icu.Text.RuleBasedCollator

Attributs: RegisterAttribute

Implémente: IFreezable IJavaObject IJavaPeerable ICloneable IComparator IDisposable

Remarques

[icu enhancement] ICU’s replacement for java.text.Collator. ; Les méthodes, les champs et d’autres fonctionnalités spécifiques à l’ICU sont étiquetées «[icu] ».

Collator effectue une comparaison de chaînes sensibles aux paramètres régionaux. Une sous-classe concrète, RuleBasedCollator, permet la personnalisation de l’ordre de classement en utilisant des ensembles de règles.

Un collator est thread-safe uniquement lorsqu’il est figé. Voir #isFrozen() et Freezable.

En suivant les spécifications du Consortium Unicode pour l’algorithme de classement Unicode (UCA), il existe 5 niveaux de force différents utilisés dans les comparaisons :

ulliPRIMARY force : en général, il est utilisé pour indiquer les différences entre les caractères de base (par exemple, « a » < « b »). C’est la différence la plus forte. Par exemple, les dictionnaires sont divisés en différentes sections par caractère de base. liSECONDARY force : les accents dans les caractères sont considérés comme des différences secondaires (par exemple, « as » < "&agrave ; s" < « at »). D’autres différences entre les lettres peuvent également être considérées comme des différences secondaires, selon la langue. Une différence secondaire est ignorée lorsqu’il existe une différence principale n’importe où dans les chaînes. liTERTIARY force : Les différences majuscules et minuscules dans les caractères sont distinguées à la force tertiaire (par exemple, « ao » < « Ao » < « a&ograve ; »). En outre, une variante d’une lettre diffère de la forme de base sur la force tertiaire (par exemple, « A » et « (A) »). Un autre exemple est la différence entre le grand et le petit Kana. Une différence tertiaire est ignorée lorsqu’il existe une différence primaire ou secondaire n’importe où dans les chaînes. liQUATERNARY force : Lorsque la ponctuation est ignorée (voir Ignorer les ponctuations dans le Guide de l’utilisateur) à la force PRIMARY to TERTIARY, un niveau de force supplémentaire peut être utilisé pour distinguer les mots avec et sans ponctuation (par exemple, « ab » < « a-b » < « aB »). Cette différence est ignorée lorsqu’il existe une différence PRIMARY, SECONDARY ou TERTIARY. La force QUATERNARY ne doit être utilisée que si la ponctuation est ignorée. <li>IDENTICAL force : Lorsque toutes les autres forces sont égales, la force IDENTIQUE est utilisée comme un brise-cravate. Les valeurs de point de code Unicode de la forme NFD de chaque chaîne sont comparées, juste en cas de différence. Par exemple, les marques de cantillation hébraïques ne se distinguent qu’à cette force. Cette force doit être utilisée avec parcimonie, car seules les différences de valeur de point de code entre deux chaînes sont une occurrence extrêmement rare. L’utilisation de cette force diminue considérablement les performances des API de comparaison et de génération de clés de classement. Cette force augmente également la taille de la clé de classement. </ul>

Contrairement au JDK, le Collator d’ICU4J ne traite que de 2 modes de décomposition, le mode de décomposition canonique et l’autre qui n’utilise aucune décomposition. Le mode de décomposition de compatibilité, java.text.Collator.FULL_DECOMPOSITION n’est pas pris en charge ici. Si le mode de décomposition canonique est défini, le Collator gère correctement le texte non normalisé, produisant les mêmes résultats que si le texte a été normalisé dans NFD. Si la décomposition canonique est désactivée, il incombe à l’utilisateur de s’assurer que tout le texte est déjà dans le formulaire approprié avant d’effectuer une comparaison ou avant d’obtenir une clé de classement.

Pour plus d’informations sur le service de classement, consultez le Guide utilisateur.

Exemples d’utilisation

// Get the Collator for US English and set its strength to PRIMARY
            Collator usCollator = Collator.getInstance(Locale.US);
            usCollator.setStrength(Collator.PRIMARY);
            if (usCollator.compare("abc", "ABC") == 0) {
                System.out.println("Strings are equivalent");
            }

            The following example shows how to compare two strings using the
            Collator for the default locale.

            // Compare two strings in the default locale
            Collator myCollator = Collator.getInstance();
            myCollator.setDecomposition(NO_DECOMPOSITION);
            if (myCollator.compare("&agrave;&#92;u0325", "a&#92;u0325&#768;") != 0) {
                System.out.println("&agrave;&#92;u0325 is not equals to a&#92;u0325&#768; without decomposition");
                myCollator.setDecomposition(CANONICAL_DECOMPOSITION);
                if (myCollator.compare("&agrave;&#92;u0325", "a&#92;u0325&#768;") != 0) {
                    System.out.println("Error: &agrave;&#92;u0325 should be equals to a&#92;u0325&#768; with decomposition");
                }
                else {
                    System.out.println("&agrave;&#92;u0325 is equals to a&#92;u0325&#768; with decomposition");
                }
            }
            else {
                System.out.println("Error: &agrave;&#92;u0325 should be not equals to a&#92;u0325&#768; without decomposition");
            }

Java documentation pour android.icu.text.Collator.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Constructeurs

Nom	Description
Collator()	Constructeur par défaut vide pour rendre javadocs heureux
Collator(IntPtr, JniHandleOwnership)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.

Champs

Nom	Description
CanonicalDecomposition	Obsolète. Valeur du mode de décomposition.
FullDecomposition	Obsolète. <strong>[icu] Remarque :</strong> ceci est destiné à la compatibilité descendante avec les API Java uniquement.
Identical	Obsolète. Valeur de force collator la plus petite.
NoDecomposition	Obsolète. Valeur du mode de décomposition.
Primary	Obsolète. Valeur de force de collator la plus forte.
Quaternary	Obsolète. <strong>[icu]</strong> Fourth level collator force value.
Secondary	Obsolète. Valeur de force de collator de deuxième niveau.
Tertiary	Obsolète. Valeur de force de collator de troisième niveau.

Propriétés

Nom	Description
Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
Decomposition	Retourne le mode de décomposition de ce Collator. -ou- Définit le mode de décomposition de ce Collator.
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
Instance	Retourne le collator pour les paramètres régionaux par défaut actuels.
IsFrozen	Détermine si l’objet a été figé ou non.
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
JniPeerMembers	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
MaxVariable	<strong>[icu]</strong> Renvoie le groupe de réorganisation maximal dont les caractères sont affectés par le comportement de gestion de remplacement.
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
Strength	Retourne l’attribut de force de ce collator. -ou- Définit l’attribut de force de ce collator.
TailoredSet	<strong>[icu]</strong> Renvoie un UnicodeSet qui contient tous les caractères et séquences adaptés dans ce collator.
ThresholdClass	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
ThresholdType	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
UCAVersion	[icu] Retourne la version UCA de cet objet collator.
VariableTop	[icu] Obtient la valeur supérieure de la variable d’un Collator.
Version	[icu] Retourne la version de cet objet collator.

Méthodes

Nom	Description
Clone()	Clone le collateur.
CloneAsThawed()	Fournit l’opération de clonage.
Compare(Object, Object)	Compare l’objet source à l’objet cible.
Compare(String, String)	Compare la chaîne de texte source à la chaîne de texte cible en fonction des règles, de la force et de la décomposition de ce collator.
Construct(JniObjectReference, JniObjectReferenceOptions)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
Equals(Object)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
Equals(String, String)	Compare l’égalité de deux chaînes de texte à l’aide des règles, de la force et de la décomposition de ce collator.
Freeze()	Fige le collateur.
GetAvailableLocales()	Retourne l’ensemble de paramètres régionaux, en tant qu’objets Régionaux, pour lesquels les collators sont installés.
GetAvailableULocales()	<strong>[icu]</strong> Renvoie l’ensemble des paramètres régionaux, en tant qu’objets ULocale, pour lesquels les collators sont installés.
GetCollationKey(String)	Transforme la chaîne en une clé de classement adaptée à une comparaison répétée efficace.
GetDisplayName(Locale, Locale)	<strong>[icu]</strong> Renvoie le nom du collator pour objectLocale, localisé pour displayLocale.
GetDisplayName(Locale)	<strong>[icu]</strong> Renvoie le nom du collator pour objectLocale, localisé pour les paramètres régionaux par défaut `DISPLAY` .
GetDisplayName(ULocale, ULocale)	<strong>[icu]</strong> Renvoie le nom du collator pour objectLocale, localisé pour displayLocale.
GetDisplayName(ULocale)	<strong>[icu]</strong> Renvoie le nom du collator pour objectLocale, localisé pour les paramètres régionaux par défaut `DISPLAY` .
GetEquivalentReorderCodes(Int32)	Récupère tous les codes de réorganisation regroupés avec le code de réorganisation donné.
GetFunctionalEquivalent(String, ULocale, Boolean[])	<strong>[icu]</strong> Renvoie les paramètres régionaux fonctionnels équivalents pour les paramètres régionaux demandés donnés, en ce qui concerne le mot clé donné, pour le service de classement.
GetFunctionalEquivalent(String, ULocale)	<strong>[icu]</strong> Renvoie les paramètres régionaux fonctionnels équivalents pour les paramètres régionaux demandés donnés, en ce qui concerne le mot clé donné, pour le service de classement.
GetHashCode()	Retourne une valeur de code de hachage pour l’objet. (Hérité de Object)
GetInstance(Locale)	Retourne le collator pour les paramètres régionaux souhaités.
GetInstance(ULocale)	<strong>[icu]</strong> Renvoie le collator pour les paramètres régionaux souhaités.
GetKeywords()	<strong>[icu]</strong> Renvoie un tableau de tous les mots clés possibles pertinents pour le classement.
GetKeywordValues(String)	<strong>[icu]</strong> Donné un mot clé, retourne un tableau de toutes les valeurs de ce mot clé actuellement utilisé.
GetKeywordValuesForLocale(String, ULocale, Boolean)	<strong>[icu]</strong> Given a key and a locale, retourne un tableau de valeurs de chaîne dans un ordre préféré qui ferait une différence.
GetReorderCodes()	Récupère les codes de réorganisation de ce collator.
JavaFinalize()	Obsolète. Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetMaxVariable(Int32)	<strong>[icu]</strong> Définit le haut de la variable en haut du groupe de réorganisation spécifié.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
SetReorderCodes(Int32[])	Définit les codes de réorganisation de ce collator.
ToArray<T>()	Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToString()	Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object)
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
IComparator.Compare(Object, Object)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
IFreezable.CloneAsThawed()	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
IFreezable.Freeze()	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
IJavaPeerable.Disposed()	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
IJavaPeerable.Finalized()	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`. (Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	<strong>[icu enhancement]</strong> ICU remplacement de l’ICU pour `java.text.Collator`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à