CollationElementIterator Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
CollationElementIterator es un iterador creado por un RuleBasedCollator para recorrer una cadena.
[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- Herencia
- Atributos
Comentarios
CollationElementIterator es un iterador creado por un RuleBasedCollator para recorrer una cadena. El resultado devuelto de cada iteración es un elemento de intercalación de 32 bits (CE) que define la prioridad de ordenación del siguiente carácter o secuencia de caracteres en la cadena de origen.
Por ejemplo, considere lo siguiente en Eslovaco y en la intercalación española tradicional: <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> Y en la intercalación del libro telefónico alemán, <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>
Para la comparación de ordenación de intercalación, los resultados del elemento de intercalación no se pueden comparar simplemente mediante operadores aritméticos básicos, por ejemplo, <, == o >, se debe realizar un procesamiento adicional. Puede encontrar detalles en la Guía del usuario de ICU. Un ejemplo de uso de CollationElementIterator para la comparación de ordenación de intercalación es la clase android.icu.text.StringSearch.
Para construir un objeto CollationElementIterator, los usuarios llaman al método getCollationElementIterator() en un RuleBasedCollator que define el criterio de ordenación deseado.
Ejemplo: <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>
El método next() devuelve el orden de intercalación del carácter siguiente en función del nivel de comparación del intercalador. El método previous() devuelve el orden de intercalación del carácter anterior en función del nivel de comparación del intercalador. El iterador del elemento de intercalación se mueve solo en una dirección entre las llamadas a reset(), setOffset() o setText(). Es decir, next() y previous() no se pueden usar entre sí. Siempre que se llame a previous() después de next() o viceversa, reset(), setOffset() o setText() debe llamarse primero para restablecer el estado, desplazando la posición actual al final o al inicio de la cadena (reset() o setText()), o la posición especificada (setOffset()). Por lo tanto, en la siguiente llamada de next() o previous(), se devolverá el orden de intercalación primero o último, o el orden de intercalación en la posición especificada. Si se realiza un cambio de dirección sin una de estas llamadas, el resultado es indefinido.
Esta clase no es subclasable.
Java documentación para android.icu.text.CollationElementIterator.
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.
Campos
| Nombre | Description |
|---|---|
| Ignorable |
El iterador devuelve esta constante en los métodos next() y previous() cuando se omitirá un resultado de elemento de intercalación. |
| Nullorder |
El iterador devuelve esta constante en los métodos next() y previous() cuando se ha alcanzado el final o el principio de la cadena de origen y no hay más elementos de intercalación válidos para devolver. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| 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 |
|
| JniPeerMembers |
|
| Offset |
Devuelve el desplazamiento de caracteres en la cadena de origen correspondiente al siguiente elemento de intercalación. -o bien- Establece el iterador para que apunte al elemento de intercalación correspondiente al carácter en el desplazamiento especificado. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object) |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object) |
Métodos
| Nombre | Description |
|---|---|
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| 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() |
|
| Equals(Object) |
|
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| GetMaxExpansion(Int32) |
Devuelve la longitud máxima de cualquier secuencia de expansión que termine con el elemento de intercalación especificado. |
| 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) |
| Next() |
Obtenga el siguiente elemento de intercalación en la cadena de origen. |
| 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) |
| Previous() |
Obtenga el elemento de intercalación anterior en la cadena de origen. |
| PrimaryOrder(Int32) |
Devuelve el orden principal del elemento de intercalación especificado, i. |
| Reset() |
Restablece el cursor al principio de la cadena. |
| SecondaryOrder(Int32) |
Devuelve el orden secundario del elemento de intercalación especificado, i. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetText(ICharacterIterator) |
Establezca un nuevo iterador de cadena de origen para iteración y restablezca el desplazamiento al principio del texto. |
| SetText(String) |
Establezca una nueva cadena de origen para la iteración y restablezca el desplazamiento al principio del texto. |
| SetText(UCharacterIterator) |
Establezca un nuevo iterador de cadena de origen para iteración y restablezca el desplazamiento al principio del texto. |
| TertiaryOrder(Int32) |
Devuelve el orden terciario del elemento de intercalación especificado, i. |
| 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 |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |