ICharacterIterator Interfaz

Definición

Espacio de nombres:

Java.Text

Ensamblado:

Mono.Android.dll

Esta interfaz define un protocolo para la iteración bidireccional sobre texto.

[Android.Runtime.Register("java/text/CharacterIterator", "", "Java.Text.ICharacterIteratorInvoker")]
public interface ICharacterIterator : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.ICloneable

[<Android.Runtime.Register("java/text/CharacterIterator", "", "Java.Text.ICharacterIteratorInvoker")>]
type ICharacterIterator = interface
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Derivado

Java.Text.IAttributedCharacterIterator

Java.Text.StringCharacterIterator

Atributos

RegisterAttribute

Implementaciones

IJavaObject IJavaPeerable ICloneable IDisposable

Comentarios

Esta interfaz define un protocolo para la iteración bidireccional sobre texto. El iterador recorre en iteración una secuencia limitada de caracteres. Los caracteres se indexan con valores que comienzan por el valor devuelto por getBeginIndex() y continúan por el valor devuelto por getEndIndex()-1.

Los iteradores mantienen un índice de caracteres actual, cuyo intervalo válido es de getBeginIndex() a getEndIndex(); el valor getEndIndex() se incluye para permitir el control de intervalos de texto de longitud cero y por motivos históricos. El índice actual se puede recuperar llamando a getIndex() y se establece directamente llamando a setIndex(), first() y last().

Los métodos previous() y next() se usan para la iteración. Devuelven DONE si se moverían fuera del intervalo de getBeginIndex() a getEndIndex() -1, lo que indica que el iterador ha alcanzado el final de la secuencia. DONE también lo devuelven otros métodos para indicar que el índice actual está fuera de este intervalo.

Ejemplos:

Recorrer el texto de principio a fin

{@code
            public void traverseForward(CharacterIterator iter) {
                for(char c = iter.first(); c != CharacterIterator.DONE; c = iter.next()) {
                    processChar(c);
                }
            }
            }

Recorrer el texto hacia atrás, desde el final hasta el principio

{@code
            public void traverseBackward(CharacterIterator iter) {
                for(char c = iter.last(); c != CharacterIterator.DONE; c = iter.previous()) {
                    processChar(c);
                }
            }
            }

Recorra hacia delante y hacia atrás desde una posición determinada en el texto. Las llamadas a notBoundary() de este ejemplo representan algunos criterios de detención adicionales.

{@code
            public void traverseOut(CharacterIterator iter, int pos) {
                for (char c = iter.setIndex(pos);
                         c != CharacterIterator.DONE && notBoundary(c);
                         c = iter.next()) {
                }
                int end = iter.getIndex();
                for (char c = iter.setIndex(pos);
                        c != CharacterIterator.DONE && notBoundary(c);
                        c = iter.previous()) {
                }
                int start = iter.getIndex();
                processSection(start, end);
            }
            }

Agregado en la versión 1.1.

Documentación de Java para java.text.CharacterIterator.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Campos

Done	Constante que se devuelve cuando el iterador ha llegado al final o al principio del texto.

Propiedades

BeginIndex	Devuelve el índice begin.
EndIndex	Devuelve el índice final.
Handle	Obtiene el valor JNI del objeto Android subyacente. (Heredado de IJavaObject)
Index	Devuelve el índice actual.
JniIdentityHashCode	Devuelve el valor de java.lang.System.identityHashCode() para la instancia ajustada. (Heredado de IJavaPeerable)
JniManagedPeerState	Estado del mismo nivel administrado. (Heredado de IJavaPeerable)
JniPeerMembers	Compatibilidad con la invocación y el acceso de miembros. (Heredado de IJavaPeerable)
PeerReference	Devuelve una JniObjectReference de la instancia de objeto Java ajustada. (Heredado de IJavaPeerable)

Métodos

Clone()	Crear una copia de este iterador
Current()	Obtiene el carácter en la posición actual (tal y como devuelve getIndex()).
Disposed()	Se llama cuando se ha eliminado la instancia. (Heredado de IJavaPeerable)
DisposeUnlessReferenced()	Si no hay referencias pendientes a esta instancia, llama a Dispose(); de lo contrario, no hace nada. (Heredado de IJavaPeerable)
Finalized()	Se llama cuando se ha finalizado la instancia. (Heredado de IJavaPeerable)
First()	Establece la posición para getBeginIndex() y devuelve el carácter en esa posición.
Last()	Establece la posición en getEndIndex()-1 (getEndIndex() si el texto está vacío) y devuelve el carácter en esa posición.
Next()	Incrementa el índice del iterador en uno y devuelve el carácter en el nuevo índice.
Previous()	Disminuye el índice del iterador por uno y devuelve el carácter en el nuevo índice.
SetIndex(Int32)	Establece la posición en la posición especificada en el texto y devuelve ese carácter.
SetJniIdentityHashCode(Int32)	Establezca el valor devuelto por JniIdentityHashCode. (Heredado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Esta interfaz define un protocolo para la iteración bidireccional sobre texto. (Heredado de IJavaPeerable)
SetPeerReference(JniObjectReference)	Establezca el valor devuelto por PeerReference. (Heredado de IJavaPeerable)
UnregisterFromRuntime()	Anule el registro de esta instancia para que el entorno de ejecución no lo devuelva de invocaciones futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Heredado de IJavaPeerable)

Métodos de extensión

JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Esta interfaz define un protocolo para la iteración bidireccional sobre texto.
GetJniTypeName(IJavaPeerable)	Esta interfaz define un protocolo para la iteración bidireccional sobre texto.