Class ParsePosition
java.lang.Object
java.text.ParsePosition
ParsePosition
is a simple class used byFormat
and its subclasses to keep track of the current position during parsing. TheparseObject
method in the variousFormat
classes requires aParsePosition
object as an argument. By design, as you parse through a string with different formats, you can use the sameParsePosition
, since the index parameter records the current position.
- Since:
- 1.1
- See Also:
Constructor Summary
ConstructorsConstructorDescriptionParsePosition
(int index) Create a new ParsePosition with the given initial index.Method Summary
Modifier and TypeMethodDescriptionboolean
Overrides equalsint
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.toString()
Return a string representation of this ParsePosition.
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
hashCode
toString