ICharacterIterator Interface

Definição

[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 por texto. O iterador itera em uma sequência limitada de caracteres. Os caracteres são indexados com valores que começam com o valor retornado por getBeginIndex() e continuam por meio do 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 o tratamento 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 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:

Percorrer 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);
                }
            }
            }

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

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

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