ICharacterIterator Interface
Definição
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.
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
- Atributos
- Implementações
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 |
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 |
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 |
SetJniManagedPeerState(JniManagedPeerStates) |
Essa interface define um protocolo para iteração bidirecional sobre texto. (Herdado de IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Defina o valor retornado por |
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. |