Module java.base
Package java.text

Class ParsePosition

java.lang.Object
java.text.ParsePosition

public class ParsePosition extends Object
ParsePosition is a simple class used by Format and its subclasses to keep track of the current position during parsing. The parseObject method in the various Format classes requires a ParsePosition object as an argument.

By design, as you parse through a string with different formats, you can use the same ParsePosition, since the index parameter records the current position.

Since:
1.1
See Also:
  • Constructor Summary

    Constructors
    Constructor
    Description
    ParsePosition(int index)
    Create a new ParsePosition with the given initial index.
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    Overrides equals
    int
    Retrieve the index at which an error occurred, or -1 if the error index has not been set.
    int
    Retrieve the current parse position.
    int
    Returns a hash code for this ParsePosition.
    void
    setErrorIndex(int ei)
    Set the index at which a parse error occurred.
    void
    setIndex(int index)
    Set the current parse position.
    Return a string representation of this ParsePosition.

    Methods declared in class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • ParsePosition

      public ParsePosition(int index)
      Create a new ParsePosition with the given initial index.
      Parameters:
      index - initial index
  • Method Details

    • getIndex

      public int getIndex()
      Retrieve the current parse position. On input to a parse method, this is the index of the character at which parsing will begin; on output, it is the index of the character following the last character parsed.
      Returns:
      the current parse position
    • setIndex

      public void setIndex(int index)
      Set the current parse position.
      Parameters:
      index - the current parse position
    • setErrorIndex

      public void setErrorIndex(int ei)
      Set the index at which a parse error occurred. Formatters should set this before returning an error code from their parseObject method. The default value is -1 if this is not set.
      Parameters:
      ei - the index at which an error occurred
      Since:
      1.2
    • getErrorIndex

      public int getErrorIndex()
      Retrieve the index at which an error occurred, or -1 if the error index has not been set.
      Returns:
      the index at which an error occurred
      Since:
      1.2
    • equals

      public boolean equals(Object obj)
      Overrides equals
      Overrides:
      equals in class Object
      Parameters:
      obj - the reference object with which to compare.
      Returns:
      true if this object is the same as the obj argument; false otherwise.
      See Also:
    • hashCode

      public int hashCode()
      Returns a hash code for this ParsePosition.
      Overrides:
      hashCode in class Object
      Returns:
      a hash code value for this object
      See Also:
    • toString

      public String toString()
      Return a string representation of this ParsePosition.
      Overrides:
      toString in class Object
      Returns:
      a string representation of this object