Java Platform 1.2

java.text
Class StringCharacterIterator

java.lang.Object
  |
  +--java.text.StringCharacterIterator

public final class StringCharacterIterator
extends Object
implements CharacterIterator

StringCharacterIterator implements the CharacterIterater protocol for a String. The StringCharacterIterator class iterates over the entire String.

See Also:
CharacterIterator

Constructor Summary
StringCharacterIterator(String text)
          Constructs an iterator with an initial index of 0.
StringCharacterIterator(String text, int pos)
          Constructs an iterator with the specified initial index.
StringCharacterIterator(String text, int begin, int end, int pos)
          Constructs an iterator over the given range of the given string, with the index set at the specified position.
 
Method Summary
 Object clone()
          Creates a copy of this iterator.
 char current()
          Implements CharacterIterator.current() for String.
 boolean equals(Object obj)
          Compares the equality of two StringCharacterIterator objects.
 char first()
          Implements CharacterIterator.first() for String.
 int getBeginIndex()
          Implements CharacterIterator.getBeginIndex() for String.
 int getEndIndex()
          Implements CharacterIterator.getEndIndex() for String.
 int getIndex()
          Implements CharacterIterator.getIndex() for String.
 int hashCode()
          Computes a hashcode for this iterator.
 char last()
          Implements CharacterIterator.last() for String.
 char next()
          Implements CharacterIterator.next() for String.
 char previous()
          Implements CharacterIterator.previous() for String.
 char setIndex(int p)
          Implements CharacterIterator.setIndex() for String.
 void setText(String text)
          Reset this iterator to point to a new string.
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StringCharacterIterator

public StringCharacterIterator(String text)
Constructs an iterator with an initial index of 0.

StringCharacterIterator

public StringCharacterIterator(String text,
                               int pos)
Constructs an iterator with the specified initial index.
Parameters:
text - The String to be iterated over
pos - Initial iterator position

StringCharacterIterator

public StringCharacterIterator(String text,
                               int begin,
                               int end,
                               int pos)
Constructs an iterator over the given range of the given string, with the index set at the specified position.
Parameters:
text - The String to be iterated over
begin - Index of the first character
end - Index of the character following the last character
pos - Initial iterator position
Method Detail

setText

public void setText(String text)
Reset this iterator to point to a new string. This package-visible method is used by other java.text classes that want to avoid allocating new StringCharacterIterator objects every time their setText method is called.
Parameters:
text - The String to be iterated over

first

public char first()
Implements CharacterIterator.first() for String.
Specified by:
first in interface CharacterIterator
See Also:
CharacterIterator.first()

last

public char last()
Implements CharacterIterator.last() for String.
Specified by:
last in interface CharacterIterator
See Also:
CharacterIterator.last()

setIndex

public char setIndex(int p)
Implements CharacterIterator.setIndex() for String.
Specified by:
setIndex in interface CharacterIterator
See Also:
CharacterIterator.setIndex(int)

current

public char current()
Implements CharacterIterator.current() for String.
Specified by:
current in interface CharacterIterator
See Also:
CharacterIterator.current()

next

public char next()
Implements CharacterIterator.next() for String.
Specified by:
next in interface CharacterIterator
See Also:
CharacterIterator.next()

previous

public char previous()
Implements CharacterIterator.previous() for String.
Specified by:
previous in interface CharacterIterator
See Also:
CharacterIterator.previous()

getBeginIndex

public int getBeginIndex()
Implements CharacterIterator.getBeginIndex() for String.
Specified by:
getBeginIndex in interface CharacterIterator
See Also:
CharacterIterator.getBeginIndex()

getEndIndex

public int getEndIndex()
Implements CharacterIterator.getEndIndex() for String.
Specified by:
getEndIndex in interface CharacterIterator
See Also:
CharacterIterator.getEndIndex()

getIndex

public int getIndex()
Implements CharacterIterator.getIndex() for String.
Specified by:
getIndex in interface CharacterIterator
See Also:
CharacterIterator.getIndex()

equals

public boolean equals(Object obj)
Compares the equality of two StringCharacterIterator objects.
Parameters:
obj - the StringCharacterIterator object to be compared with.
Returns:
true if the given obj is the same as this StringCharacterIterator object; false otherwise.
Overrides:
equals in class Object

hashCode

public int hashCode()
Computes a hashcode for this iterator.
Returns:
A hash code
Overrides:
hashCode in class Object

clone

public Object clone()
Creates a copy of this iterator.
Specified by:
clone in interface CharacterIterator
Returns:
A copy of this
Overrides:
clone in class Object

Java Platform 1.2

Submit a bug or feature Version 1.2 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.