CharacterIterator

public interface CharacterIterator
implements Cloneable

Known Indirect Subclasses AttributedCharacterIterator AttributedCharacterIterator AttributedCharacterIterator允许迭代文本和相关的属性信息。

该接口定义了一个用于文本双向迭代的协议。 迭代器迭代有限的字符序列。 字符使用从getBeginIndex（）返回的值开始并继续通过getEndIndex（） - 1返回的值进行索引。

迭代器保持当前字符索引，其有效范围从getBeginIndex（）到getEndIndex（）; 包含值getEndIndex（）以允许处理零长度文本范围和历史原因。 当前索引可以通过调用getIndex（）来获取，并通过调用setIndex（），first（）和last（）直接设置。

previous（）和next（）方法用于迭代。 如果它们超出getBeginIndex（）到getEndIndex（）-1的范围，它们将返回DONE，表示迭代器已到达序列的末尾。 DONE也通过其他方法返回，以指示当前索引超出此范围。

例子：

从头到尾遍历文本

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

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

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

Summary

Constants

char DONE

Public methods

Object clone ()

char current ()

char first ()

int getBeginIndex ()

int getEndIndex ()

int getIndex ()

char last ()

char next ()

char previous ()

char setIndex (int position)