|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
public interface CharacterIterator
此接口定义了对文本进行双向迭代的协议。迭代器对有界字符序列进行迭代。这些字符使用从 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); } }从文本中给定的位置进行正向和逆向遍历。在此例中调用 notBoundary() 表示某个附加的停止遍历的标准。
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); }
StringCharacterIterator
,
AttributedCharacterIterator
字段摘要 | |
---|---|
static char |
DONE 当迭代器已到达文本末尾或开始处时返回的常量。 |
方法摘要 | |
---|---|
Object |
clone() 创建此迭代器的一个副本 |
char |
current() 获取当前位置(由 getIndex() 返回)的字符。 |
char |
first() 将位置设置为 getBeginIndex(),并返回该位置的字符。 |
int |
getBeginIndex() 返回文本的起始索引。 |
int |
getEndIndex() 返回文本的结束索引。 |
int |
getIndex() 返回当前索引。 |
char |
last() 将位置设置为 getEndIndex()-1(如果文本为空,则为 getEndIndex()),并返回该位置的字符。 |
char |
next() 将迭代器的索引加一,并返回新索引处的字符。 |
char |
previous() 将迭代器的索引减一,并返回新索引处的字符。 |
char |
setIndex(int position) 将位置设置为文本中的指定位置,并返回该字符。 |
字段详细信息 |
---|
static final char DONE
方法详细信息 |
---|
char first()
getBeginIndex()
char last()
getEndIndex()
char current()
getIndex()
char next()
char previous()
char setIndex(int position)
position
- 文本中的位置。从 getBeginIndex() 到 getEndIndex() 的有效值。如果提供了无效值,则抛出 IllegalArgumentException。
int getBeginIndex()
int getEndIndex()
int getIndex()
Object clone()
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。