ICharacterIterator Interface

Definição

Namespace:

Java.Text

Assembly:

Mono.Android.dll

Essa interface define um protocolo para iteração bidirecional 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

Implementações

IJavaObject IJavaPeerable ICloneable IDisposable

Comentários

Essa interface define um protocolo para iteração bidirecional sobre texto. O iterador itera sobre uma sequência limitada de caracteres. Os caracteres são indexados com valores começando com o valor retornado por getBeginIndex() e continuando pelo valor retornado por getEndIndex()-1.

Os iteradores mantêm um índice de caracteres atual, cujo intervalo válido é de getBeginIndex() a getEndIndex(); o valor getEndIndex() é incluído para permitir a manipulação de intervalos de texto de comprimento zero e por motivos históricos. O índice atual pode ser recuperado chamando getIndex() e definido diretamente chamando setIndex(), first() e last().

Os métodos previous() e next() são usados para iteração. Eles retornam DONE se moverem para fora do intervalo de getBeginIndex() para getEndIndex() -1, sinalizando que o iterador atingiu o final da sequência. DONE também é retornado por outros métodos para indicar que o índice atual está fora desse intervalo.

Exemplos:

Percorra o texto do início ao fim

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

Percorrer o texto para trás, de ponta a ponta

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

Percorra para frente e para trás a partir de uma determinada posição no texto. As chamadas para notBoundary() neste exemplo representam alguns critérios de interrupção adicionais.

{@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);
            }
            }

Adicionado em 1.1.

Documentação Java para java.text.CharacterIterator.

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

Campos

Done	Constante que é retornada quando o iterador atingiu o final ou o início do texto.

Propriedades

BeginIndex	Retorna o índice de início.
EndIndex	Retorna o índice final.
Handle	Obtém o valor JNI do objeto Android subjacente. (Herdado de IJavaObject)
Index	Retorna o índice atual.
JniIdentityHashCode	Retorna o valor de java.lang.System.identityHashCode() para a instância encapsulada. (Herdado de IJavaPeerable)
JniManagedPeerState	Estado do par gerenciado. (Herdado de IJavaPeerable)
JniPeerMembers	Acesso de membros e suporte à invocação. (Herdado de IJavaPeerable)
PeerReference	Retorna uma JniObjectReference das instâncias do objeto Java encapsulado. (Herdado de IJavaPeerable)

Métodos

Clone()	Criar uma cópia deste iterador
Current()	Obtém o caractere na posição atual (conforme retornado por getIndex()).
Disposed()	Chamado quando a instância tiver sido descartada. (Herdado de IJavaPeerable)
DisposeUnlessReferenced()	Se não houver referências pendentes a este caso, então chame Dispose(), caso contrário, não faz nada. (Herdado de IJavaPeerable)
Finalized()	Chamado quando a instância tiver sido finalizada. (Herdado de IJavaPeerable)
First()	Define a posição como getBeginIndex() e retorna o caractere nessa posição.
Last()	Define a posição como getEndIndex()-1 (getEndIndex() se o texto estiver vazio) e retorna o caractere nessa posição.
Next()	Incrementa o índice do iterador em um e retorna o caractere no novo índice.
Previous()	Decrementa o índice do iterador por um e retorna o caractere no novo índice.
SetIndex(Int32)	Define a posição para a posição especificada no texto e retorna esse caractere.
SetJniIdentityHashCode(Int32)	Defina o valor retornado por JniIdentityHashCode. (Herdado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Essa interface define um protocolo para iteração bidirecional sobre texto. (Herdado de IJavaPeerable)
SetPeerReference(JniObjectReference)	Defina o valor retornado por PeerReference. (Herdado de IJavaPeerable)
UnregisterFromRuntime()	Cancele o registro dessa instância para que o tempo de execução não a retorne de chamadas futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Herdado de IJavaPeerable)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Essa interface define um protocolo para iteração bidirecional sobre texto.
GetJniTypeName(IJavaPeerable)	Essa interface define um protocolo para iteração bidirecional sobre texto.