CollationElementIterator 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.
CollationElementIterator est un itérateur créé par un RuleBasedCollator pour parcourir une chaîne.
[Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class CollationElementIterator : Java.Lang.Object[<Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)>]
type CollationElementIterator = class
inherit Object- Héritage
- Attributs
Remarques
CollationElementIterator est un itérateur créé par un RuleBasedCollator pour parcourir une chaîne. Le résultat de retour de chaque itération est un élément de classement 32 bits (CE) qui définit la priorité de classement du caractère ou de la séquence de caractères suivant dans la chaîne source.
Pour illustration, tenez compte des éléments suivants en slovaque et en classement espagnol traditionnel : <blockquote>
"ca" -> the first collation element is CE('c') and the second
collation element is CE('a').
"cha" -> the first collation element is CE('ch') and the second
collation element is CE('a').
</blockquote> And in German phonebook collation, <blockquote>
Since the character 'æ' is a composed character of 'a' and 'e', the
iterator returns two collation elements for the single character 'æ'
"æb" -> the first collation element is collation_element('a'), the
second collation element is collation_element('e'), and the
third collation element is collation_element('b').
</blockquote>
Pour la comparaison des classements de classement, les résultats de l’élément de classement ne peuvent pas être comparés simplement à l’aide d’opérateurs arithmétiques de base, par exemple , <, == ou >, un traitement supplémentaire doit être effectué. Vous trouverez des détails dans le Guide de l’utilisateur de l’ICU. Un exemple d’utilisation de CollationElementIterator pour la comparaison des classements est la classe android.icu.text.StringSearch.
Pour construire un objet CollationElementIterator, les utilisateurs appellent la méthode getCollationElementIterator() sur un RuleBasedCollator qui définit l’ordre de tri souhaité.
Exemple : <blockquote>
String testString = "This is a test";
RuleBasedCollator rbc = new RuleBasedCollator("&a<b");
CollationElementIterator iterator = rbc.getCollationElementIterator(testString);
int primaryOrder = iterator.IGNORABLE;
while (primaryOrder != iterator.NULLORDER) {
int order = iterator.next();
if (order != iterator.IGNORABLE &&
order != iterator.NULLORDER) {
// order is valid, not ignorable and we have not passed the end
// of the iteration, we do something
primaryOrder = CollationElementIterator.primaryOrder(order);
System.out.println("Next primary order 0x" +
Integer.toHexString(primaryOrder));
}
}
</blockquote>
La méthode next() retourne l’ordre de classement du caractère suivant en fonction du niveau de comparaison du collateur. La méthode previous() retourne l’ordre de classement du caractère précédent en fonction du niveau de comparaison du collator. L’itérateur de l’élément classement se déplace uniquement dans une direction entre les appels à reset(), setOffset() ou setText(). Autrement dit, next() et previous() ne peuvent pas être utilisés entre elles. Chaque fois que précédent() doit être appelé après next() ou vice versa, reset(), setOffset() ou setText() doit être appelé en premier pour réinitialiser l’état, déplacer la position actuelle vers la fin ou le début de la chaîne (reset() ou setText()) ou la position spécifiée (setOffset()). Par conséquent, à l’appel suivant de next() ou previous(), le premier ou le dernier ordre de classement, ou l’ordre de classement à la position spécifiée est retourné. Si un changement de direction est effectué sans l’un de ces appels, le résultat n’est pas défini.
Cette classe n’est pas sous-classable.
Java documentation pour android.icu.text.CollationElementIterator.
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.
Champs
| Nom | Description |
|---|---|
| Ignorable |
Cette constante est retournée par l’itérateur dans les méthodes next() et previous() lorsqu’un résultat d’élément de classement doit être ignoré. |
| Nullorder |
Cette constante est retournée par l’itérateur dans les méthodes next() et previous() lorsque la fin ou le début de la chaîne source a été atteinte, et il n’y a plus d’éléments de classement valides à retourner. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Offset |
Retourne le décalage de caractère dans la chaîne source correspondant à l’élément de classement suivant. -ou- Définit l’itérateur pour qu’il pointe vers l’élément de classement correspondant au caractère au décalage spécifié. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| 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. (Hérité de Object) |
| 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. (Hérité de Object) |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| 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() |
|
| Equals(Object) |
|
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetMaxExpansion(Int32) |
Retourne la longueur maximale de toute séquence d’expansion qui se termine par l’élément de classement spécifié. |
| 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) |
| Next() |
Obtenez l’élément de classement suivant dans la chaîne source. |
| 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) |
| Previous() |
Obtenez l’élément de classement précédent dans la chaîne source. |
| PrimaryOrder(Int32) |
Retourne l’ordre principal de l’élément de classement spécifié, i. |
| Reset() |
Réinitialise le curseur au début de la chaîne. |
| SecondaryOrder(Int32) |
Retourne l’ordre secondaire de l’élément de classement spécifié, i. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetText(ICharacterIterator) |
Définissez un nouvel itérateur de chaîne source pour l’itération et réinitialisez le décalage au début du texte. |
| SetText(String) |
Définissez une nouvelle chaîne source pour l’itération et réinitialisez le décalage au début du texte. |
| SetText(UCharacterIterator) |
Définissez un nouvel itérateur de chaîne source pour l’itération et réinitialisez le décalage au début du texte. |
| TertiaryOrder(Int32) |
Retourne l’ordre tertiaire de l’élément de classement spécifié, i. |
| 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 |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
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) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |