CollationElementIterator Classe

Definizione

Spazio dei nomi:

Android.Icu.Text

Assembly:

Mono.Android.dll

CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa.

[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

Ereditarietà

Object

Object

CollationElementIterator

Attributi

RegisterAttribute

Commenti

CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. Il risultato restituito di ogni iterazione è un elemento di regole di confronto a 32 bit (CE) che definisce la priorità di ordinamento del carattere o della sequenza di caratteri successivi nella stringa di origine.

Si consideri, ad esempio, quanto segue in Slovacco e nelle regole di confronto in spagnolo tradizionale: <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> E nelle regole di confronto della rubrica in tedesco, <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>

Per il confronto degli ordini delle regole di confronto, i risultati degli elementi delle regole di confronto non possono essere confrontati semplicemente usando operatori aritmetici di base, ad esempio <, == o >, è necessario eseguire ulteriori elaborazioni. I dettagli sono disponibili nella Guida per l'utente dell'ICU. Un esempio di utilizzo di CollationElementIterator per il confronto degli ordini delle regole di confronto è la classe android.icu.text.StringSearch.

Per costruire un oggetto CollationElementIterator, gli utenti chiamano il metodo getCollationElementIterator() in un RuleBasedCollator che definisce l'ordinamento desiderato.

Esempio: <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>

Il metodo next() restituisce l'ordine delle regole di confronto del carattere successivo in base al livello di confronto del collator. Il metodo previous() restituisce l'ordine delle regole di confronto del carattere precedente in base al livello di confronto del collator. L'iteratore dell'elemento Collation si sposta in una sola direzione tra le chiamate a reset(), setOffset() o setText(). Vale a dire, next() e previous() non possono essere usati tra loro. Ogni volta che previous() deve essere chiamato dopo next() o viceversa, reset(), setOffset() o setText() deve essere chiamato prima per reimpostare lo stato, spostando la posizione corrente alla fine o all'inizio della stringa (reset() o setText()) o la posizione specificata (setOffset()). Di conseguenza, alla chiamata successiva di next() o previous(), il primo o l'ultimo ordine delle regole di confronto o l'ordine delle regole di confronto nella posizione specificata verranno restituite. Se una modifica della direzione viene eseguita senza una di queste chiamate, il risultato non è definito.

Questa classe non è sottoclassabile.

per android.icu.text.CollationElementIterator.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Campi

Nome	Descrizione
Ignorable	Questa costante viene restituita dall'iteratore nei metodi next() e previous() quando un risultato di un elemento delle regole di confronto deve essere ignorato.
Nullorder	Questa costante viene restituita dall'iteratore nei metodi next() e previous() quando è stata raggiunta la fine o l'inizio della stringa di origine e non sono disponibili altri elementi delle regole di confronto validi da restituire.

Proprietà

Nome	Descrizione
Class	Restituisce la classe di runtime di questo Objectoggetto . (Ereditato da Object)
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
JniIdentityHashCode	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
JniPeerMembers	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa.
Offset	Restituisce l'offset di caratteri nella stringa di origine corrispondente all'elemento delle regole di confronto successivo. -oppure- Imposta l'iteratore in modo che punti all'elemento delle regole di confronto corrispondente al carattere in corrispondenza dell'offset specificato.
PeerReference	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object)
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object)

Metodi

Nome	Descrizione
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
Dispose()	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
Dispose(Boolean)	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
GetHashCode()	Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object)
GetMaxExpansion(Int32)	Restituisce la lunghezza massima di qualsiasi sequenza di espansione che termina con l'elemento delle regole di confronto specificato.
JavaFinalize()	Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object)
Next()	Ottiene l'elemento delle regole di confronto successivo nella stringa di origine.
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object)
Previous()	Ottiene l'elemento delle regole di confronto precedente nella stringa di origine.
PrimaryOrder(Int32)	Restituisce l'ordine primario dell'elemento delle regole di confronto specificato, i.
Reset()	Reimposta il cursore all'inizio della stringa.
SecondaryOrder(Int32)	Restituisce l'ordine secondario dell'elemento delle regole di confronto specificato, i.
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
SetText(ICharacterIterator)	Impostare un nuovo iteratore della stringa di origine per l'iterazione e reimpostare l'offset all'inizio del testo.
SetText(String)	Impostare una nuova stringa di origine per l'iterazione e reimpostare l'offset all'inizio del testo.
SetText(UCharacterIterator)	Impostare un nuovo iteratore della stringa di origine per l'iterazione e reimpostare l'offset all'inizio del testo.
TertiaryOrder(Int32)	Restituisce l'ordine terziario dell'elemento delle regole di confronto specificato, i.
ToArray<T>()	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
ToString()	Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object)
UnregisterFromRuntime()	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
Wait()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64, Int32)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IJavaPeerable.Disposed()	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
IJavaPeerable.Finalized()	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa. (Ereditato da Object)

Metodi di estensione

Nome	Descrizione
GetJniTypeName(IJavaPeerable)	Ottiene il nome JNI del tipo dell'istanza selfdi .
JavaAs<TResult>(IJavaPeerable)	Provare a digitare selfTResult, verificando che la coercizione sia valida sul lato Java.
JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato dal runtime Android.
JavaCast<TResult>(IJavaObject)	CollationElementIterator è un iteratore creato da un RuleBasedCollator per scorrere una stringa.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Provare a digitare selfTResult, verificando che la coercizione sia valida sul lato Java.