Format.parseObject

Format.parseObject

Class Overview | Class Members | This Package | All Packages

Syntax 1
public abstract Object parseObject( String source, ParsePosition status )
Parameters
ParsePosition
Input-Output parameter.

Before calling, set status.index to the offset you want to start parsing at in the source. After calling, status.index is the end of the text you parsed. If error occurs, index is unchanged.

When parsing, leading whitespace is discarded (with successful parse), while trailing whitespace is left as is.

Example: Parsing "_12_xy" (where _ represents a space) for a number, with index == 0 will result in the number 12, with status.index updated to 3 (just before the second space). Parsing a second time will result in a ParseException since "xy" is not a number, and leave index at 3.

Subclasses will typically supply specific parse methods that return different types of values. Since methods can't overload on return types, these will typically be named "parse", while this polymorphic method will always be called parseObject. Any parse method that does not take a status should throw ParseException when no text in the required format is at the start position.

Returns
Object parsed from string. In case of error, returns null.
Description
Parses a string to produce an object. Subclasses will typically implement for particular object, such as:
       String format (Number obj);
       String format (long obj);
       String format (double obj);
       Number parse (String str);
 

See Also
ParsePosition



Syntax 2
public Object parseObject( String source ) throws ParseException
Description
Parses a string to produce an object.

Exceptions
ParseException if the specified string is invalid.