Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| J2ME Foundation
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.text
Class StringCharacterIterator

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

All Implemented Interfaces:
  CharacterIterator, Cloneable

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`

Fields inherited from interface java.text.CharacterIterator
`DONE`

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.
  Overrides:
    `equals` in class `Object`
  Parameters:
    `obj` - the StringCharacterIterator object to be compared with.
  Returns:
    true if the given obj is the same as this StringCharacterIterator object; false otherwise.

### hashCode

    public int hashCode()

  Computes a hashcode for this iterator.
  Overrides:
    `hashCode` in class `Object`
  Returns:
    A hash code

### clone

    public Object clone()

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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| J2ME Foundation
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Java is a trademark or registred trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo, Alto, California, 94303, U.S.A All Rights Reserved. < /font >