compact1, compact2, compact3

java.text

Interface CharacterIterator

All Superinterfaces:

Cloneable

All Known Subinterfaces:

AttributedCharacterIterator

所有已知实现类：

Segment， StringCharacterIterator

public interface CharacterIterator
extends Cloneable

该接口定义了一个用于文本的双向迭代的协议。迭代器遍历有限字符序列。字符值开始与价值被getbeginindex()继续通过返回值返回getendindex() - 1。

迭代器保持经常性指标，其有效范围是从getbeginindex()到getendindex()；价值getendindex()包含允许零长度的文本范围的处理和历史原因。目前指数可以通过调用getindex()通过调用setindex()，first()直接提取，并last()。

方法previous()和next()用于迭代。他们的回报如果他们将从外面getbeginindex()到getendindex() - 1范围内，表明已达到的迭代器序列结束。所做的也是通过其他方法返回的，表明当前索引在这个范围之外。

实例：

遍历文本从开始到结束

 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

Field Summary

Fields

Modifier and Type	Field and Description
static char	DONE 当迭代器已达到文本的结尾或开始时返回的常数。

方法摘要

Modifier and Type	Method and Description
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) 将位置设置为文本中指定的位置，并返回该字符。

Field Detail

DONE

static final char DONE

当迭代器已达到文本的结尾或开始时返回的常数。价值是“\\ UFFFF”，“不”字的价值，不应以任何有效的Unicode字符串出现。

另请参见：

Constant Field Values

方法详细信息

first

char first()

设置位置getbeginindex()返回那个位置的字符。

结果

文本中的第一个字符，或如果文本是空的

另请参见：

getBeginIndex()

last

char last()

集getendindex() - 1的位置（getendindex()如果文本是空的）并返回在那个位置的字符。

结果

文本中的最后一个字符，或如果文本是空的

另请参见：

getEndIndex()

current

char current()

获取当前位置的字符（如返回getindex()）。

结果

如果当前位置关闭文本的位置，则当前位置或所做的字符。

另请参见：

getIndex()

next

char next()

通过一个增量迭代迭代器的索引，并返回新索引中的字符。如果得到的指数大于或等于getendindex()，当前指数复位getendindex()和值做返回。

结果

在新的位置或做的字符，如果新的位置是关闭的文本范围结束。

previous

char previous()

使迭代器的指数和返回新指标的特点。如果目前的指数getbeginindex()，指数仍然处于getbeginindex()和值做返回。

结果

这个角色在新位置或者如果当前位置等于getbeginindex()。

setIndex

char setIndex(int position)

将位置设置为文本中指定的位置，并返回该字符。

参数

position -在文本中的位置。有效值的范围从getbeginindex()到getendindex()。IllegalArgumentException是如果提供了一个无效的值被。

结果

字符在指定位置或指定位置做如果等于getendindex()

getBeginIndex

int getBeginIndex()

返回文本的开始索引。

结果

文本开始的索引。

getEndIndex

int getEndIndex()

返回文本的结束索引。该索引是在文本结束后的第一个字符的索引。

结果

文本中的最后一个字符后的索引

getIndex

int getIndex()

返回当前索引。

结果

当前指数。

clone

Object clone()

创建此迭代器的副本

结果

这个副本