Question

java.lang.Object
  └java.text.StringCharacterIterator

所有已实现的接口：

Cloneable, CharacterIterator

---

public final class StringCharacterIterator

extends Object

implements CharacterIterator

StringCharacterIterator 为 String 实现 CharacterIterater 协议。 StringCharacterIterator 类对整个 String 进行迭代。

另请参见：

CharacterIterator

---

字段摘要

从接口 java.text.CharacterIterator 继承的字段
DONE

构造方法摘要
StringCharacterIterator(Stringtext) 构造初始索引为 0 的迭代器。
StringCharacterIterator(Stringtext, intpos) 构造具有指定的初始索引的迭代器。
StringCharacterIterator(Stringtext, intbegin, intend, intpos) 构造对给定字符串的给定范围进行迭代的迭代器（其索引设置为指定位置）。

方法摘要
Object	clone() 创建此迭代器的副本。
char	current() 实现 String 的 CharacterIterator.current()。
boolean	equals(Objectobj) 比较两个 StringCharacterIterator 对象的相等性。
char	first() 实现 String 的 CharacterIterator.first()。
int	getBeginIndex() 实现 String 的 CharacterIterator.getBeginIndex()。
int	getEndIndex() 实现 String 的 CharacterIterator.getEndIndex()。
int	getIndex() 实现 String 的 CharacterIterator.getIndex()。
int	hashCode() 计算此迭代器的哈希码。
char	last() 实现 String 的 CharacterIterator.last()。
char	next() 实现 String 的 CharacterIterator.next()。
char	previous() 实现 String 的 CharacterIterator.previous()。
char	setIndex(intp) 实现 String 的 CharacterIterator.setIndex()。
void	setText(Stringtext) 将此迭代器重置为指向一个新的字符串。

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

StringCharacterIterator

public StringCharacterIterator(Stringtext)

构造初始索引为 0 的迭代器。

---

StringCharacterIterator

public StringCharacterIterator(Stringtext,
                               intpos)

构造具有指定的初始索引的迭代器。

参数：

text - 要对其进行迭代的 String

pos - 初始迭代器位置

---

StringCharacterIterator

public StringCharacterIterator(Stringtext,
                               intbegin,
                               intend,
                               intpos)

构造对给定字符串的给定范围进行迭代的迭代器（其索引设置为指定位置）。

参数：

text - 要对其进行迭代的 String

begin - 首字符的索引

end - 最后一个字符后面的字符的索引

pos - 迭代器的初始位置

方法详细信息

setText

public void setText(Stringtext)

将此迭代器重置为指向一个新的字符串。此包可见的（package-visible）方法由其他 java.text 类使用，这些类需要在每次调用其 setText 方法时避免分配新的 StringCharacterIterator 对象。

参数：

text - 要对其进行迭代的 String

从以下版本开始：

1.2

---

first

public char first()

实现 String 的 CharacterIterator.first()。

指定者：

接口 CharacterIterator 中的 first

返回：

文本中的第一个字符，如果文本为空，则返回 DONE

另请参见：

CharacterIterator.first()

---

last

public char last()

实现 String 的 CharacterIterator.last()。

指定者：

接口 CharacterIterator 中的 last

返回：

文本中的最后一个字符，如果文本为空，则返回 DONE

另请参见：

CharacterIterator.last()

---

setIndex

public char setIndex(intp)

实现 String 的 CharacterIterator.setIndex()。

指定者：

接口 CharacterIterator 中的 setIndex

参数：

p - 文本中的位置。从 getBeginIndex() 到 getEndIndex() 的有效值。如果提供了无效值，则抛出 IllegalArgumentException。

返回：

指定位置的字符；如果指定位置等于 getEndIndex()，则返回 DONE

另请参见：

CharacterIterator.setIndex(int)

---

current

public char current()

实现 String 的 CharacterIterator.current()。

指定者：

接口 CharacterIterator 中的 current

返回：

当前位置的字符；如果当前位置已超出文本末尾，则返回 DONE。

另请参见：

CharacterIterator.current()

---

next

public char next()

实现 String 的 CharacterIterator.next()。

指定者：

接口 CharacterIterator 中的 next

返回：

新位置的索引；如果该新位置已超出文本范围的末尾，则返回 DONE。

另请参见：

CharacterIterator.next()

---

previous

public char previous()

实现 String 的 CharacterIterator.previous()。

指定者：

接口 CharacterIterator 中的 previous

返回：

新位置的字符；如果当前位置等于 getBeginIndex()，则返回 DONE。

另请参见：

CharacterIterator.previous()

---

getBeginIndex

public int getBeginIndex()

实现 String 的 CharacterIterator.getBeginIndex()。

指定者：

接口 CharacterIterator 中的 getBeginIndex

返回：

文本开始处的索引。

另请参见：

CharacterIterator.getBeginIndex()

---

getEndIndex

public int getEndIndex()

实现 String 的 CharacterIterator.getEndIndex()。

指定者：

接口 CharacterIterator 中的 getEndIndex

返回：

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

另请参见：

CharacterIterator.getEndIndex()

---

getIndex

public int getIndex()

实现 String 的 CharacterIterator.getIndex()。

指定者：

接口 CharacterIterator 中的 getIndex

返回：

当前索引。

另请参见：

CharacterIterator.getIndex()

---

equals

public boolean equals(Objectobj)

比较两个 StringCharacterIterator 对象的相等性。

覆盖：

类 Object 中的 equals

参数：

obj - 要进行比较的 StringCharacterIterator 对象。

返回：

如果给定的 obj 与 StringCharacterIterator 对象相同，则返回 true；否则返回 false。

另请参见：

Object.hashCode() , Hashtable

---

hashCode

public int hashCode()

计算此迭代器的哈希码。

覆盖：

类 Object 中的 hashCode

返回：

哈希码

另请参见：

Object.equals(java.lang.Object) , Hashtable

---

clone

public Object clone()

创建此迭代器的副本。

指定者：

接口 CharacterIterator 中的 clone

覆盖：

类 Object 中的 clone

返回：

此迭代器的副本

另请参见：

Cloneable