当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

StringCharacterIterator (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.text
类 StringCharacterIterator

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(String text)           构造初始索引为 0 的迭代器。
StringCharacterIterator(String text, int pos)           构造具有指定的初始索引的迭代器。
StringCharacterIterator(String text, int begin, int end, int pos)           构造对给定字符串的给定范围进行迭代的迭代器（其索引设置为指定位置）。

 

方法摘要
Object	clone()           创建此迭代器的副本。
char	current()           实现 String 的 CharacterIterator.current()。
boolean	equals(Object obj)           比较两个 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(int p)           实现 String 的 CharacterIterator.setIndex()。
void	setText(String text)           将此迭代器重置为指向一个新的字符串。

 

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

 

构造方法详细信息

StringCharacterIterator

public StringCharacterIterator(String text)

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

---

StringCharacterIterator

public StringCharacterIterator(String text,
                               int pos)

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

参数：

text - 要对其进行迭代的 String

pos - 初始迭代器位置

---

StringCharacterIterator

public StringCharacterIterator(String text,
                               int begin,
                               int end,
                               int pos)

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

参数：

text - 要对其进行迭代的 String

begin - 首字符的索引

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

pos - 迭代器的初始位置

方法详细信息

setText

public void setText(String text)

将此迭代器重置为指向一个新的字符串。此包可见的（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(int p)

实现 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(Object obj)

比较两个 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

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。