Collator Clase

Definición

<strong>[icu enhancement]</strong> 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
Herencia
Derivado
Atributos
Implementaciones

Comentarios

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.  Los métodos, los campos y otras funcionalidades específicas de ICU se etiquetan como "<strong>[icu]</strong>".

El collador realiza una comparación de cadenas que distingue la configuración regional. Una subclase concreta, RuleBasedCollator, permite personalizar el orden de intercalación mediante el uso de conjuntos de reglas.

Un collador solo es seguro para subprocesos cuando se inmoviliza. Consulte #isFrozen() y Freezable.

Siguiendo las especificaciones del Consorcio Unicode para el algoritmo de intercalación Unicode (UCA), hay 5 niveles diferentes de intensidad usados en comparaciones:

fuerza ulliPRIMARY: normalmente, se usa para indicar diferencias entre caracteres base (por ejemplo, "a" < "b"). Es la diferencia más fuerte. Por ejemplo, los diccionarios se dividen en diferentes secciones por carácter base. liSECUNDARIA fuerza: Los acentos de los caracteres se consideran diferencias secundarias (por ejemplo, "as" < "&agrave; s" < "at"). Otras diferencias entre letras también se pueden considerar diferencias secundarias, dependiendo del idioma. Se omite una diferencia secundaria cuando hay una diferencia principal en cualquier parte de las cadenas. liFUERZA TERCIOSA: Diferencias en mayúsculas y minúsculas en caracteres se distinguen en la fuerza terciaria (por ejemplo, "ao" < "Ao" < "a&ograve;"). Además, una variante de una letra difiere de la forma base de la fuerza terciaria (como "A" y "(A)"). Otro ejemplo es la diferencia entre kana grande y pequeño. Se omite una diferencia terciaria cuando hay una diferencia principal o secundaria en cualquier parte de las cadenas. liQUATERNARY strength: When punctuation is ignored (see Ignoreing Punctuations in the User Guide) at PRIMARY to TERY strength, an additional strength level can be used to distinguish words with and without punctuation (for example, "ab" < "a-b" < "aB"). Esta diferencia se omite cuando hay una diferencia PRINCIPAL, SECUNDARIA o TERCIARIA. La fuerza QUATERNARY solo debe utilizarse si se requiere omitir la puntuación. <li>IDÉNTICA fuerza: cuando todos los demás puntos fuertes son iguales, la fuerza IDÉNTICA se usa como un desempate. Los valores de punto de código Unicode del formulario NFD de cada cadena se comparan, solo en caso de que no haya ninguna diferencia. Por ejemplo, las marcas de cantillación hebreo solo se distinguen en esta fuerza. Esta intensidad se debe usar con moderación, ya que solo las diferencias de valor de punto de código entre dos cadenas es una aparición extremadamente rara. El uso de esta intensidad reduce considerablemente el rendimiento de las API de generación de claves de comparación e intercalación. Esta intensidad también aumenta el tamaño de la clave de intercalación. </ul>

A diferencia del JDK, el collador de ICU4J solo se ocupa de dos modos de descomposición, el modo de descomposición canónica y otro que no usa ninguna descomposición. El modo de descomposición de compatibilidad, java.text.Collator.FULL_DECOMPOSITION no se admite aquí. Si se establece el modo de descomposición canónica, el collador controla el texto sin normalizar correctamente, lo que genera los mismos resultados que si el texto se normalizase en NFD. Si la descomposición canónica está desactivada, es responsabilidad del usuario asegurarse de que todo el texto ya está en el formato adecuado antes de realizar una comparación o antes de obtener una CollationKey.

Para obtener más información sobre el servicio de intercalación, consulte la Guía del usuario.

Ejemplos 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 documentación para android.icu.text.Collator.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Constructores

Nombre Description
Collator()

Constructor predeterminado vacío para que javadocs sea feliz

Collator(IntPtr, JniHandleOwnership)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

Campos

Nombre Description
CanonicalDecomposition
Obsoletos.

Valor del modo de descomposición.

FullDecomposition
Obsoletos.

<strong>[icu] Nota:</strong> Esto es solo para la compatibilidad con versiones anteriores con las API de Java.

Identical
Obsoletos.

Valor de intensidad del collador más pequeño.

NoDecomposition
Obsoletos.

Valor del modo de descomposición.

Primary
Obsoletos.

Valor de resistencia del intercalador más fuerte.

Quaternary
Obsoletos.

<strong>[icu]</fuerte> valor de fuerza del intercalador de cuarto nivel.

Secondary
Obsoletos.

Valor de intensidad del intercalador de segundo nivel.

Tertiary
Obsoletos.

Valor de resistencia del intercalador de tercer nivel.

Propiedades

Nombre Description
Class

Devuelve la clase en tiempo de ejecución de este Objectobjeto .

(Heredado de Object)
Decomposition

Devuelve el modo de descomposición de este collador. -o bien- Establece el modo de descomposición de este collador.

Handle

Identificador de la instancia de Android subyacente.

(Heredado de Object)
Instance

Devuelve el collador de la configuración regional predeterminada actual.

IsFrozen

Determina si el objeto se ha inmovilizado o no.

JniIdentityHashCode

Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad.

(Heredado de Object)
JniManagedPeerState

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
JniPeerMembers

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

MaxVariable

<strong>[icu]</strong> Devuelve el grupo de reordenación máximo cuyos caracteres se ven afectados por el comportamiento de control alternativo.

PeerReference

Obtiene la referencia de objeto JNI para este Java del mismo nivel.

(Heredado de Object)
Strength

Devuelve el atributo de fuerza de este collador. -o bien- Establece el atributo de fuerza de este collador.

TailoredSet

<strong>[icu]</strong> Devuelve un UnicodeSet que contiene todos los caracteres y secuencias adaptados en este intercalador.

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

[icu] Devuelve la versión UCA de este objeto de intercalador.

VariableTop

[icu] Obtiene el valor superior de la variable de un collador.

Version

[icu] Devuelve la versión de este objeto de intercalador.

Métodos

Nombre Description
Clone()

Clona el intercalador.

CloneAsThawed()

Proporciona la operación de clonación.

Compare(Object, Object)

Compara el objeto de origen con el objeto de destino.

Compare(String, String)

Compara la cadena de texto de origen con la cadena de texto de destino según las reglas, la intensidad y la descomposición de este collador.

Construct(JniObjectReference, JniObjectReferenceOptions)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
Dispose()

Libera los recursos mantenidos por este Java del mismo nivel.

(Heredado de Object)
Dispose(Boolean)

Libera los recursos mantenidos por este Java del mismo nivel.

(Heredado de Object)
DisposeUnlessReferenced()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
Equals(Object)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
Equals(Object)

Indica si algún otro objeto es "igual a" este.

(Heredado de Object)
Equals(String, String)

Compara la igualdad de dos cadenas de texto con las reglas, la intensidad y la descomposición de este collador.

Freeze()

Inmoviliza el intercalador.

GetAvailableLocales()

Devuelve el conjunto de configuraciones regionales, como objetos De configuración regional, para los que se instalan los intercaladores.

GetAvailableULocales()

<strong>[icu]</strong> Devuelve el conjunto de configuraciones regionales, como objetos ULocale, para los que se instalan los intercaladores.

GetCollationKey(String)

Transforma la cadena en una collationKey adecuada para una comparación repetida eficaz.

GetDisplayName(Locale, Locale)

<strong>[icu]</strong> Devuelve el nombre del intercalador del objetoLocale, localizado para displayLocale.

GetDisplayName(Locale)

<strong>[icu]</strong> Devuelve el nombre del intercalador del objetoLocale, localizado para la configuración regional predeterminada DISPLAY .

GetDisplayName(ULocale, ULocale)

<strong>[icu]</strong> Devuelve el nombre del intercalador del objetoLocale, localizado para displayLocale.

GetDisplayName(ULocale)

<strong>[icu]</strong> Devuelve el nombre del intercalador del objetoLocale, localizado para la configuración regional predeterminada DISPLAY .

GetEquivalentReorderCodes(Int32)

Recupera todos los códigos de reordenación que se agrupan con el código de reordenación especificado.

GetFunctionalEquivalent(String, ULocale, Boolean[])

<strong>[icu]</strong> Devuelve la configuración regional funcionalmente equivalente para la configuración regional solicitada especificada, con respecto a la palabra clave dada, para el servicio de intercalación.

GetFunctionalEquivalent(String, ULocale)

<strong>[icu]</strong> Devuelve la configuración regional funcionalmente equivalente para la configuración regional solicitada especificada, con respecto a la palabra clave dada, para el servicio de intercalación.

GetHashCode()

Devuelve un valor de código hash para el objeto .

(Heredado de Object)
GetInstance(Locale)

Devuelve el collador para la configuración regional deseada.

GetInstance(ULocale)

<strong>[icu]</strong> Devuelve el collador para la configuración regional deseada.

GetKeywords()

<strong>[icu]</strong> Devuelve una matriz de todas las palabras clave posibles que son relevantes para la intercalación.

GetKeywordValues(String)

<strong>[icu]</strong> Dado una palabra clave, devuelve una matriz de todos los valores de esa palabra clave que están actualmente en uso.

GetKeywordValuesForLocale(String, ULocale, Boolean)

<strong>[icu]</strong> Dado una clave y una configuración regional, devuelve una matriz de valores de cadena en un orden preferido que haría una diferencia.

GetReorderCodes()

Recupera los códigos de reordenación de este intercalador.

JavaFinalize()

Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto .

(Heredado de Object)
Notify()

Activa un único subproceso que está esperando en el monitor de este objeto.

(Heredado de Object)
NotifyAll()

Activa todos los subprocesos que están esperando en el monitor de este objeto.

(Heredado de Object)
SetHandle(IntPtr, JniHandleOwnership)

Establece la propiedad Handle.

(Heredado de Object)
SetMaxVariable(Int32)

<strong>[icu]</strong> Establece la variable superior en la parte superior del grupo de reordenación especificado.

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
SetReorderCodes(Int32[])

Establece los códigos de reordenación para este intercalador.

ToArray<T>()

Crea una matriz administrada a partir de este contenedor de matriz Java.

(Heredado de Object)
ToString()

Devuelve una representación de cadena del objeto .

(Heredado de Object)
UnregisterFromRuntime()

Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad.

(Heredado de Object)
Wait()

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><>

(Heredado de Object)
Wait(Int64, Int32)

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real.

(Heredado de Object)
Wait(Int64)

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real.

(Heredado de Object)

Implementaciones de interfaz explícitas

Nombre 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.

(Heredado de JavaObject)
IJavaPeerable.Finalized()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

(Heredado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

Métodos de extensión

Nombre Description
GetJniTypeName(IJavaPeerable)

Obtiene el nombre JNI del tipo de la instancia self.

JavaAs<TResult>(IJavaPeerable)

Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.

JavaCast<TResult>(IJavaObject)

Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.

JavaCast<TResult>(IJavaObject)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.Collator.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.

Se aplica a