ICharacterIterator Schnittstelle

Definition

[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

Abgeleitet

Java.Text.IAttributedCharacterIterator

Java.Text.StringCharacterIterator

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ICloneable IDisposable

Hinweise

Diese Schnittstelle definiert ein Protokoll für bidirektionale Iteration über Text. Der Iterator durchläuft eine begrenzungsgebundene Abfolge von Zeichen. Zeichen werden mit Werten indiziert, die mit dem von getBeginIndex() zurückgegebenen Wert beginnen und den von getEndIndex()-1 zurückgegebenen Wert fortsetzen.

Iteratoren verwalten einen aktuellen Zeichenindex, dessen gültiger Bereich von getBeginIndex() bis getEndIndex(); Der Wert "getEndIndex()" ist enthalten, um die Behandlung von Textbereichen der Länge Null und aus historischen Gründen zu ermöglichen. Der aktuelle Index kann abgerufen werden, indem getIndex() aufgerufen und direkt durch Aufrufen von setIndex(), first() und last() festgelegt wird.

Die Methoden "previous()" und "next()" werden für die Iteration verwendet. Sie geben DONE zurück, wenn sie außerhalb des Bereichs von getBeginIndex() zu getEndIndex() -1 verschoben würden, was signalisiert, dass der Iterator das Ende der Sequenz erreicht hat. DONE wird auch von anderen Methoden zurückgegeben, um anzugeben, dass sich der aktuelle Index außerhalb dieses Bereichs befindet.

Beispiele:

Durchlaufen des Texts von Anfang bis Ende

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

Durchlaufen sie den Text rückwärts, von Ende bis Anfang

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

Durchlaufen Sie sowohl vorwärts als auch rückwärts von einer bestimmten Position im Text. Aufrufe an notBoundary() in diesem Beispiel stellen einige zusätzliche Stoppkriterien dar.

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

In 1.1 hinzugefügt.

Java-Dokumentation für java.text.CharacterIterator.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Felder

Eigenschaften

Methoden

Erweiterungsmethoden

Gilt für: