Collator Classe
Définition
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.
La Collator classe effectue une comparaison sensible aux String paramètres régionaux.
[Android.Runtime.Register("java/text/Collator", DoNotGenerateAcw=true)]
public abstract class Collator : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.ICloneable, Java.Util.IComparator
[<Android.Runtime.Register("java/text/Collator", DoNotGenerateAcw=true)>]
type Collator = class
inherit Object
interface ICloneable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IComparator
- Héritage
- Dérivé
- Attributs
- Implémente
Remarques
La Collator classe effectue une comparaison sensible aux String paramètres régionaux. Vous utilisez cette classe pour créer des routines de recherche et de tri pour le texte en langage naturel.
Collator est une classe de base abstraite. Les sous-classes implémentent des stratégies de classement spécifiques. Une sous-classe est RuleBasedCollatoractuellement fournie avec la plateforme Java et s’applique à un large éventail de langues. D’autres sous-classes peuvent être créées pour gérer des besoins plus spécialisés.
Comme d’autres classes sensibles aux paramètres régionaux, vous pouvez utiliser la méthode de fabrique statique, getInstancepour obtenir l’objet approprié Collator pour un paramètre régional donné. Vous devrez uniquement examiner les sous-classes de Collator si vous devez comprendre les détails d’une stratégie de classement particulière ou si vous devez modifier cette stratégie.
L’exemple suivant montre comment comparer deux chaînes à l’aide des Collator paramètres régionaux par défaut.
<blockquote>
{@code
// Compare two strings in the default locale
Collator myCollator = Collator.getInstance();
if( myCollator.compare("abc", "ABC") < 0 )
System.out.println("abc is less than ABC");
else
System.out.println("abc is greater than or equal to ABC");
}
</blockquote>
Vous pouvez définir une Collator<propriété em>force</em> pour déterminer le niveau de différence considéré comme significatif dans les comparaisons. Quatre points forts sont fournis : PRIMARY, , SECONDARYTERTIARY, et IDENTICAL. L’affectation exacte des forces aux fonctionnalités linguistiques dépend des paramètres régionaux. Par exemple, en Tchèque, « e » et « f » sont considérés comme des différences principales, tandis que « e » et « #283 » sont des différences secondaires, « e » et « E » sont des différences tertiaires et « e » et « e » sont identiques. L’exemple suivant montre comment les cas et les accents peuvent être ignorés pour l’anglais américain.
<blockquote>
//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");
}
</blockquote>
Pour comparer Stringexactement une fois, la compare méthode offre les meilleures performances. Toutefois, lors du tri d’une liste de Strings, il est généralement nécessaire de comparer chaque String fois. Dans ce cas, CollationKeyles performances sont meilleures. La CollationKey classe convertit un String en une série de bits qui peuvent être comparés au niveau du bit par rapport à d’autres CollationKeys. A CollationKey est créé par un Collator objet pour un donné String.
<br><strong>Note :</strong>CollationKeys from different Collators can be compare. Pour obtenir un exemple d’utilisation CollationKeyde s, consultez la description CollationKey de la classe.
Ajouté dans la version 1.1.
Documentation Java pour java.text.Collator.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
| Nom | Description |
|---|---|
| Collator() |
Constructeur par défaut. |
| Collator(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Champs
| Nom | Description |
|---|---|
| CanonicalDecomposition |
Valeur du mode de décomposition. |
| FullDecomposition |
Valeur du mode de décomposition. |
| Identical |
Valeur de force de collator. |
| NoDecomposition |
Valeur du mode de décomposition. |
| Primary |
Valeur de force de collator. |
| Secondary |
Valeur de force de collator. |
| Tertiary |
Valeur de force de collator. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Decomposition |
Obtenez le mode de décomposition de ce Collator. -ou- Définissez le mode de décomposition de ce Collator. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| Instance |
Obtient le collator pour les paramètres régionaux par défaut actuels. |
| JniIdentityHashCode |
La |
| JniPeerMembers |
La |
| PeerReference |
La |
| Strength |
Retourne la propriété de force de cette collator. -ou- Définit la propriété de force de ce Collator. |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Retourne un nouveau collateur avec le même mode de décomposition et la même valeur de force que ce collateur. |
| Compare(Object, Object) |
Compare ses deux arguments pour l’ordre. |
| Compare(String, String) |
Compare la chaîne source à la chaîne cible en fonction des règles de classement de ce Collator. |
| Dispose() |
La |
| Dispose(Boolean) |
La |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Equals(String, String) |
Méthode pratique pour comparer l’égalité de deux chaînes en fonction des règles de classement de ce collator. |
| GetAvailableLocales() |
Retourne un tableau de tous les paramètres régionaux pour lesquels les |
| GetCollationKey(String) |
Transforme la chaîne en une série de bits qui peuvent être comparés au niveau du bit à d’autres collationKeys. |
| GetHashCode() |
Génère le code de hachage pour ce collator. |
| GetInstance(Locale) |
Obtient le collateur pour les paramètres régionaux souhaités. |
| JavaFinalize() |
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) |
| ToArray<T>() |
La |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
La |
| 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) |
La |
| IJavaPeerable.Disposed() |
La |
| IJavaPeerable.DisposeUnlessReferenced() |
La |
| IJavaPeerable.Finalized() |
La |
| IJavaPeerable.JniManagedPeerState |
La |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
La |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
La |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
La |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |