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.

See Also:
Format

 

Constructor Summary

ParsePosition(int index)
    Create a new ParsePosition with the given initial index.
 

 

Method Summary

 boolean equals(Object obj)
    Overrides equals
 int getErrorIndex()
    Retrieve the index at which an error occurred, or -1 if the error index has not been set.
 int getIndex()
    Retrieve the current parse position.
 int hashCode()
    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.
 String toString()
    Return a string representation of this ParsePosition.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

 

Constructor Detail

 

ParsePosition

public ParsePosition(int index)
Create a new ParsePosition with the given initial index.

 

Method Detail

 

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.

 

setIndex

public void setIndex(int index)
Set 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.

 

getErrorIndex

public int getErrorIndex()
Retrieve the index at which an error occurred, or -1 if the error index has not been set.

 

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:
Object.hashCode(), Hashtable

 

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:
Object.equals(java.lang.Object), Hashtable

 

toString

public String toString()
Return a string representation of this ParsePosition.

Overrides:
toString in class Object
Returns:
a string representation of this object