Collator Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
La Collator classe esegue un confronto sensibile String alle impostazioni locali.
[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- Ereditarietà
- Derivato
- Attributi
- Implementazioni
Commenti
La Collator classe esegue un confronto sensibile String alle impostazioni locali. Questa classe viene usata per compilare routine di ricerca e ordinamento per il testo in linguaggio naturale.
Collator è una classe base astratta. Le sottoclassi implementano strategie specifiche per le regole di confronto. Una sottoclasse, RuleBasedCollator, è attualmente fornita con la piattaforma Java ed è applicabile a un'ampia gamma di linguaggi. È possibile creare altre sottoclassi per gestire esigenze più specializzate.
Analogamente ad altre classi sensibili alle impostazioni locali, è possibile usare il metodo factory statico, getInstance, per ottenere l'oggetto appropriato Collator per una determinata impostazione locale. Sarà necessario esaminare solo le sottoclassi di Collator se è necessario comprendere i dettagli di una determinata strategia di confronto o se è necessario modificare tale strategia.
Nell'esempio seguente viene illustrato come confrontare due stringhe usando per le Collator impostazioni locali predefinite.
<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>
È possibile impostare una Collatorproprietà em strength</em> per <>determinare il livello di differenza considerato significativo nei confronti. Sono disponibili quattro punti di forza: PRIMARY, SECONDARY, TERTIARYe IDENTICAL. L'assegnazione esatta dei punti di forza alle funzionalità della lingua dipende dalle impostazioni locali. Ad esempio, in Ceco, "e" e "f" sono considerate differenze primarie, mentre "e" e "ě" sono differenze secondarie, "e" e "E" sono differenze terziarie e "e" sono identiche. Di seguito viene illustrato come sia maiuscole che accenti potrebbero essere ignorati per l'inglese degli Stati Uniti.
<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>
Per confrontare Stringesattamente una volta, il compare metodo offre le migliori prestazioni. Quando tuttavia si ordina un elenco di Stringelementi, è in genere necessario confrontarlo più String volte. In questo caso, CollationKeyoffre prestazioni migliori. La CollationKey classe converte un oggetto String in una serie di bit che possono essere confrontati bit per bit rispetto ad altri CollationKey. Un CollationKey oggetto viene creato da un Collator oggetto per un oggetto specificato String.
<br><strong>Note:</strong>CollationKeys di diversi Collatornon possono essere confrontati. Vedere la descrizione della classe per CollationKey un esempio usando CollationKeys.
Aggiunta nella versione 1.1.
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.
Costruttori
| Nome | Descrizione |
|---|---|
| Collator() |
Costruttore predefinito. |
| Collator(IntPtr, JniHandleOwnership) |
Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
Campi
| Nome | Descrizione |
|---|---|
| CanonicalDecomposition |
Valore della modalità di scomposizione. |
| FullDecomposition |
Valore della modalità di scomposizione. |
| Identical |
Valore di forza dell'agente di confronto. |
| NoDecomposition |
Valore della modalità di scomposizione. |
| Primary |
Valore di forza dell'agente di confronto. |
| Secondary |
Valore di forza dell'agente di confronto. |
| Tertiary |
Valore di forza dell'agente di confronto. |
Proprietà
| Nome | Descrizione |
|---|---|
| Class |
Restituisce la classe di runtime di questo |
| Decomposition |
Ottiene la modalità di scomposizione di questo collator. -oppure- Impostare la modalità di scomposizione di questo collator. |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| Instance |
Ottiene il collator per le impostazioni locali predefinite correnti. |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniPeerMembers |
La |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object) |
| Strength |
Restituisce la proprietà di forza di questo collator. -oppure- Imposta la proprietà di forza di questo collator. |
| ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
| ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Restituisce un nuovo collator con la stessa modalità di scomposizione e lo stesso valore di forza di questo collator. |
| Compare(Object, Object) |
Confronta i due argomenti per l'ordine. |
| Compare(String, String) |
Confronta la stringa di origine con la stringa di destinazione in base alle regole di confronto per questo collator. |
| Dispose() |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Dispose(Boolean) |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| Equals(String, String) |
Metodo pratico per confrontare l'uguaglianza di due stringhe in base alle regole di confronto di questo agente di confronto. |
| GetAvailableLocales() |
Restituisce una matrice di tutte le impostazioni locali per cui i |
| GetCollationKey(String) |
Trasforma string in una serie di bit che possono essere confrontati bit per bit con altre regole di confronto. |
| GetHashCode() |
Genera il codice hash per questo collator. |
| GetInstance(Locale) |
Ottiene il collator per le impostazioni locali desiderate. |
| JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| 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) |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (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 |
|---|---|
| IComparator.Compare(Object, Object) |
Confronta i due argomenti per l'ordine. |
| IJavaPeerable.Disposed() |
Notifica al runtime di interoperabilità che il peer gestito è stato eliminato. (Ereditato da Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Rilascia questo Java peer a meno che non venga conservato da un altro riferimento gestito. (Ereditato da Object) |
| IJavaPeerable.Finalized() |
Notifica al runtime di interoperabilità che il peer gestito è stato finalizzato. (Ereditato da Object) |
| IJavaPeerable.JniManagedPeerState |
Ottiene lo stato che descrive la relazione tra questo peer gestito e il relativo riferimento JNI. (Ereditato da Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Imposta il codice hash dell'identità di interoperabilità per questo Java peer. (Ereditato da Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Imposta lo stato peer gestito e JNI per questo peer Java. (Ereditato da Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Imposta il riferimento all'oggetto JNI usato da questo peer gestito. (Ereditato da Object) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
La |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |