Module java.base

Package java.text

Class StringCharacterIterator

java.lang.Object

java.text.StringCharacterIterator

所有已实现的接口:

Cloneable, CharacterIterator

       public final class StringCharacterIterator extends Object implements CharacterIterator
      

StringCharacterIterator实现了CharacterIterator协议，用于String。 StringCharacterIterator类遍历整个String。

自:

1.1

参见:

• CharacterIterator

Field Summary

Fields declared in interface java.text.CharacterIterator

DONE

Constructor Summary

Constructors

Constructor	Description
StringCharacterIterator(String text)	用初始索引构造迭代器为0。
StringCharacterIterator(String text, int pos)	用指定的初始索引构造迭代器。
StringCharacterIterator(String text, int begin, int end, int pos)	用给定字符串的给定范围构造迭代器，并将索引设置为指定位置。

Method Summary

Modifier and Type	Method	Description
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)	将此迭代器重置为指向新字符串。

Methods declared in class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

StringCharacterIterator

             public StringCharacterIterator(String text)
            

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

参数:

text - 要迭代的String

StringCharacterIterator

             public StringCharacterIterator(String text, int pos)
            

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

参数:

text - 要迭代的字符串

pos - 初始迭代器位置

StringCharacterIterator

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

用给定字符串的给定范围构造迭代器，并将索引设置为指定位置。

参数:

text - 要迭代的字符串

begin - 第一个字符的索引

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

pos - 初始迭代器位置

Method Details

setText

             public void setText(String text)
            

将此迭代器重置为指向新字符串。其他java.text类使用此包可见方法，以避免在每次调用其setText方法时分配新的StringCharacterIterator对象。

参数:

text - 要迭代的字符串

自:

1.2

first

             public char first()
            

为String实现CharacterIterator.first()。

指定者:

first 在接口 CharacterIterator中

返回:

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

参见:

• CharacterIterator.first()

last

             public char last()
            

为String实现CharacterIterator.last()。

指定者:

last 在接口 CharacterIterator中

返回:

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

参见:

• CharacterIterator.last()

setIndex

             public char setIndex(int p)
            

为String实现CharacterIterator.setIndex()。

指定者:

setIndex 在接口 CharacterIterator中

参数:

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

返回:

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

参见:

• CharacterIterator.setIndex(int)

current

             public char current()
            

为String实现CharacterIterator.current()。

指定者:

current 在接口 CharacterIterator中

返回:

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

参见:

• CharacterIterator.current()

next

             public char next()
            

为String实现CharacterIterator.next()。

指定者:

next 在接口 CharacterIterator中

返回:

新位置处的字符，如果新位置超出文本范围则返回DONE

参见:

• CharacterIterator.next()

previous

             public char previous()
            

为String实现CharacterIterator.previous()。

指定者:

previous 在接口 CharacterIterator中

返回:

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

参见:

• CharacterIterator.previous()

getBeginIndex

             public int getBeginIndex()
            

为String实现CharacterIterator.getBeginIndex()。

指定者:

getBeginIndex 在接口 CharacterIterator中

返回:

文本开始的索引。

参见:

• CharacterIterator.getBeginIndex()

getEndIndex

             public int getEndIndex()
            

为String实现CharacterIterator.getEndIndex()。

指定者:

getEndIndex 在接口 CharacterIterator中

返回:

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

参见:

• CharacterIterator.getEndIndex()

getIndex

             public int getIndex()
            

为String实现CharacterIterator.getIndex()。

指定者:

getIndex 在接口 CharacterIterator中

返回:

当前索引。

参见:

• CharacterIterator.getIndex()

equals

             public boolean equals(Object obj)
            

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

覆盖:

equals 在类 Object中

参数:

obj - 要比较的StringCharacterIterator对象。

返回:

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

参见:

• Object.hashCode()
• HashMap

hashCode

             public int hashCode()
            

为此迭代器计算哈希码。

覆盖:

hashCode 在类 Object中

返回:

一个哈希码

参见:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

clone

             public Object clone()
            

创建此迭代器的副本。

指定者:

clone 在接口 CharacterIterator中

覆盖:

clone 在类 Object中

返回:

此迭代器的副本

参见:

• Cloneable