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

StringCharacterIteratorString 实现 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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策