Collator Classe

Definição

Namespace:: Android.Icu.Text

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

[icu enhancement] ICU's replacement for 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

Herança: Object

JavaObject

Object
Collator

Derivado: Android.Icu.Text.RuleBasedCollator

Atributos: RegisterAttribute

Implementações: IFreezable IJavaObject IJavaPeerable ICloneable IComparator IDisposable

Comentários

[icu enhancement] ICU's replacement for java.text.Collator. Métodos, campos e outras funcionalidades específicas da UTI são rotulados como '[icu]'.

O Collator executa uma comparação de cadeia de caracteres que diferencia a localidade. Uma subclasse concreta, RuleBasedCollator, permite a personalização da ordenação ordenando pelo uso de conjuntos de regras.

Um Collator é thread-safe somente quando congelado. Consulte #isFrozen() e Freezable.

Seguindo as especificações do Consórcio Unicode para o Algoritmo de Ordenação Unicode (UCA), há cinco níveis diferentes de força usados em comparações:

ulliPRIMARY strength: normalmente, isso é usado para denotar diferenças entre caracteres base (por exemplo, "a" < "b"). É a diferença mais forte. Por exemplo, dicionários são divididos em seções diferentes por caractere base. liSECONDARY strength: ênfases nos caracteres são consideradas diferenças secundárias (por exemplo, "as" < "à s" < "at"). Outras diferenças entre letras também podem ser consideradas diferenças secundárias, dependendo do idioma. Uma diferença secundária é ignorada quando há uma diferença primária em qualquer lugar nas cadeias de caracteres. liTERTIARY strength: diferenças de maiúsculas e minúsculas em caracteres são distinguidas em força terciária (por exemplo, "ao" < "Ao" < "aò"). Além disso, uma variante de uma letra difere do formulário base na força terciária (como "A" e "(A)"). Outro exemplo é a diferença entre Kana grande e pequeno. Uma diferença terciária é ignorada quando há uma diferença primária ou secundária em qualquer lugar nas cadeias de caracteres. liQUATERNARY strength: quando a pontuação é ignorada (consulte Ignorando pontuações no Guia do Usuário) em PRIMARY para a força TERCIÁRIA, um nível de força adicional pode ser usado para distinguir palavras com e sem pontuação (por exemplo, "ab" < "a-b" < "aB"). Essa diferença é ignorada quando há uma diferença PRIMÁRIA, SECUNDÁRIA ou TERCIÁRIA. A força QUATERNARY só deverá ser usada se for necessário ignorar a pontuação. <li>IDENTICAL strength: quando todos os outros pontos fortes são iguais, a força IDENTICAL é usada como um desempate. Os valores de ponto de código Unicode da forma NFD de cada cadeia de caracteres são comparados, apenas no caso de não haver diferença. Por exemplo, as marcas de cantilação hebraica só são distinguidas com essa força. Essa força deve ser usada com moderação, pois apenas diferenças de valor de ponto de código entre duas cadeias de caracteres é uma ocorrência extremamente rara. Usar essa força diminui substancialmente o desempenho das APIs de geração de chave de comparação e ordenação. Essa força também aumenta o tamanho da chave de ordenação. </ul>

Ao contrário do JDK, o Collator da ICU4J lida apenas com dois modos de decomposição, o modo de decomposição canônica e um que não usa nenhuma decomposição. O modo de decomposição de compatibilidade, java.text.Collator.FULL_DECOMPOSITION não tem suporte aqui. Se o modo de decomposição canônica for definido, o Collator manipulará o texto não normalizado corretamente, produzindo os mesmos resultados como se o texto fosse normalizado no NFD. Se a decomposição canônica estiver desativada, é responsabilidade do usuário garantir que todo o texto já esteja na forma apropriada antes de executar uma comparação ou antes de obter uma CollationKey.

Para obter mais informações sobre o serviço de ordenação, consulte o Guia do Usuário.

Exemplos de uso

// 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 documentação para android.icu.text.Collator.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome	Description
Collator()	Construtor padrão vazio para fazer javadocs felizes
Collator(IntPtr, JniHandleOwnership)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.

Campos

Nome	Description
CanonicalDecomposition	Obsoleto. Valor do modo de decomposição.
FullDecomposition	Obsoleto. <strong>[icu] Observação:</strong> Isso é para compatibilidade com versões anteriores apenas com APIs Java.
Identical	Obsoleto. Menor valor de força do Collator.
NoDecomposition	Obsoleto. Valor do modo de decomposição.
Primary	Obsoleto. Valor de força de ordenação mais forte.
Quaternary	Obsoleto. <strong>[icu]</strong> Fourth level collator strength value.
Secondary	Obsoleto. Valor de força do collator de segundo nível.
Tertiary	Obsoleto. Valor de força do collator de terceiro nível.

Propriedades

Nome	Description
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Decomposition	Retorna o modo de decomposição deste Collator. -ou- Define o modo de decomposição deste Collator.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
Instance	Retorna o Collator para a localidade padrão atual.
IsFrozen	Determina se o objeto foi congelado ou não.
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
JniPeerMembers	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
MaxVariable	<strong>[icu]</strong> Retorna o grupo de reordenação máxima cujos caracteres são afetados pelo comportamento de tratamento alternativo.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
Strength	Retorna o atributo de força desse Collator. -ou- Define o atributo de força desse Collator.
TailoredSet	<strong>[icu]</strong> Retorna um UnicodeSet que contém todos os caracteres e sequências adaptados neste collator.
ThresholdClass	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
ThresholdType	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
UCAVersion	[UTI] Retorna a versão UCA deste objeto collator.
VariableTop	[UTI] Obtém o valor superior da variável de um Collator.
Version	[UTI] Retorna a versão deste objeto collator.

Métodos

Nome	Description
Clone()	Clona o collator.
CloneAsThawed()	Fornece a operação de clone.
Compare(Object, Object)	Compara o objeto de origem com o objeto de destino.
Compare(String, String)	Compara a cadeia de caracteres de texto de origem com a cadeia de caracteres de texto de destino de acordo com as regras, a força e o modo de decomposição deste Collator.
Construct(JniObjectReference, JniObjectReferenceOptions)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
Equals(Object)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
Equals(String, String)	Compara a igualdade de duas cadeias de caracteres de texto usando as regras, a força e o modo de decomposição desse Collator.
Freeze()	Congela o collator.
GetAvailableLocales()	Retorna o conjunto de localidades, como objetos Locale, para os quais os collators são instalados.
GetAvailableULocales()	<strong>[icu]</strong> Retorna o conjunto de localidades, como objetos ULocale, para os quais os agrupadores são instalados.
GetCollationKey(String)	Transforma a Cadeia de Caracteres em uma CollationKey adequada para uma comparação repetida eficiente.
GetDisplayName(Locale, Locale)	<strong>[icu]</strong> Retorna o nome do collator para o objectLocale, localizado para o displayLocale.
GetDisplayName(Locale)	<strong>[icu]</strong> Retorna o nome do collator para o objectLocale, localizado para a localidade padrão `DISPLAY` .
GetDisplayName(ULocale, ULocale)	<strong>[icu]</strong> Retorna o nome do collator para o objectLocale, localizado para o displayLocale.
GetDisplayName(ULocale)	<strong>[icu]</strong> Retorna o nome do collator para o objectLocale, localizado para a localidade padrão `DISPLAY` .
GetEquivalentReorderCodes(Int32)	Recupera todos os códigos de reordenação agrupados com o código de reordenação especificado.
GetFunctionalEquivalent(String, ULocale, Boolean[])	<strong>[icu]</strong> Retorna a localidade funcionalmente equivalente para a localidade solicitada determinada, em relação à palavra-chave fornecida, para o serviço de ordenação.
GetFunctionalEquivalent(String, ULocale)	<strong>[icu]</strong> Retorna a localidade funcionalmente equivalente para a localidade solicitada determinada, em relação à palavra-chave fornecida, para o serviço de ordenação.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetInstance(Locale)	Retorna o Collator para a localidade desejada.
GetInstance(ULocale)	<strong>[icu]</strong> Retorna o Collator para a localidade desejada.
GetKeywords()	<strong>[icu]</strong> Retorna uma matriz de todas as palavras-chave possíveis relevantes para a ordenação.
GetKeywordValues(String)	<strong>[icu]</strong> Dada uma palavra-chave, retorna uma matriz de todos os valores para essa palavra-chave que estão em uso no momento.
GetKeywordValuesForLocale(String, ULocale, Boolean)	<strong>[icu]</strong> Dada uma chave e uma localidade, retorna uma matriz de valores de cadeia de caracteres em uma ordem preferencial que faria a diferença.
GetReorderCodes()	Recupera os códigos de reordenação para esse collator.
JavaFinalize()	Obsoleto. Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetMaxVariable(Int32)	<strong>[icu]</strong> Define a variável de cima para a parte superior do grupo de reordenação especificado.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
SetReorderCodes(Int32[])	Define os códigos de reordenação para esse collator.
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)

Implantações explícitas de interface

Nome	Description
IComparator.Compare(Object, Object)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
IFreezable.CloneAsThawed()	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
IFreezable.Freeze()	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
IJavaPeerable.Disposed()	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
IJavaPeerable.Finalized()	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`. (Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	<strong>[icu enhancement]</strong> ICU's replacement for `java.text.Collator`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a