ICharacterIterator Interface

Définition

[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

Dérivé

Java.Text.IAttributedCharacterIterator

Java.Text.StringCharacterIterator

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable ICloneable IDisposable

Remarques

Cette interface définit un protocole pour l’itération bidirectionnelle sur le texte. L’itérateur effectue une itération sur une séquence limitée de caractères. Les caractères sont indexés avec des valeurs commençant par la valeur retournée par getBeginIndex() et en continuant par la valeur retournée par getEndIndex()-1.

Les itérateurs gèrent un index de caractères actuel, dont la plage valide est comprise entre getBeginIndex() et getEndIndex() ; la valeur getEndIndex() est incluse pour permettre la gestion des plages de texte de longueur nulle et pour des raisons historiques. L’index actuel peut être récupéré en appelant getIndex() et défini directement en appelant setIndex(), first() et last().

Les méthodes previous() et next() sont utilisées pour l’itération. Ils retournent DONE s’ils se déplacent en dehors de la plage de getBeginIndex() à getEndIndex() -1, signalant que l’itérateur a atteint la fin de la séquence. DONE est également retourné par d’autres méthodes pour indiquer que l’index actuel se trouve en dehors de cette plage.

Exemples :

Parcourir le texte du début à la fin

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

Parcourir le texte vers l’arrière, de bout en bout en début

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

Parcourez à la fois vers l’avant et vers l’arrière une position donnée dans le texte. Les appels à notBoundary() dans cet exemple représentent des critères d’arrêt supplémentaires.

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

Ajouté dans la version 1.1.

Documentation Java pour java.text.CharacterIterator.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Champs

Propriétés

Méthodes

Méthodes d’extension

S’applique à