ch.randelshofer:fastdoubleparser 0.9.0 · ch.randelshofer.fastdoubleparser.JavaFloatParser

Parses a float value; the supported syntax is compatible with Float#valueOf(String).

See JavaDoubleParser for a description of the supported grammar.

Expected character lengths for values produced by Float#toString:

DecSignificand (IntegerPart + FractionPart): 1 to 8 digits
IntegerPart: 1 to 7 digits
FractionPart: 1 to 7 digits
SignedInteger in exponent: 1 to 2 digits
FloatingPointLiteral: 1 to 14 characters, e.g. "-1.2345678E-38"

Maximal input length supported by this parser:

FloatingPointLiteral with or without white space around it: Integer#MAX_VALUE - 4 = 2,147,483,643 characters.

Modifier and Type	Field and Description
private static final JavaFloatBitsFromByteArray	BYTE_ARRAY_PARSER
private static final JavaFloatBitsFromCharArray	CHAR_ARRAY_PARSER
private static final JavaFloatBitsFromCharSequence	CHAR_SEQUENCE_PARSER

Access	Constructor and Description
private	JavaFloatParser() Don't let anyone instantiate this class.

Method Summary

Modifier and Type	Method and Description
public static float	Returns: the parsed value parseFloat(CharSequence the string to be parsed str) Convenience method for calling `parseFloat(CharSequence, int, int)`.
public static float	Returns: the parsed value parseFloat(CharSequence the string to be parsed str, int the start offset of the `FloatingPointLiteral` in `str` offset, int the length of `FloatingPointLiteral` in `str` length) Parses a `FloatingPointLiteral` from a `CharSequence` and converts it into a `float` value.
public static float	Returns: the parsed value parseFloat(byte[] the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding str) Convenience method for calling `parseFloat(byte[], int, int)`.
public static float	Returns: the parsed value parseFloat(byte[] the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding str, int The index of the first byte to parse offset, int The number of bytes to parse length) Parses a `FloatingPointLiteral` from a `byte`-Array and converts it into a `float` value.
public static float	Returns: the parsed value parseFloat(char[] the string to be parsed str) Convenience method for calling `parseFloat(char[], int, int)`.
public static float	Returns: the parsed value parseFloat(char[] the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding str, int The index of the first character to parse offset, int The number of characters to parse length) Parses a `FloatingPointLiteral` from a `byte`-Array and converts it into a `float` value.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

BYTE_ARRAY_PARSER	back to summary
private static final JavaFloatBitsFromByteArray BYTE_ARRAY_PARSER

CHAR_ARRAY_PARSER	back to summary
private static final JavaFloatBitsFromCharArray CHAR_ARRAY_PARSER

CHAR_SEQUENCE_PARSER	back to summary
private static final JavaFloatBitsFromCharSequence CHAR_SEQUENCE_PARSER

Constructor Detail

JavaFloatParser	back to summary
private JavaFloatParser() Don't let anyone instantiate this class.

Method Detail

parseFloat back to summary

parseFloat	back to summary
public static float parseFloat(CharSequence str) throws NumberFormatException Convenience method for calling `parseFloat(CharSequence, int, int)`. Parameters str:CharSequence the string to be parsed Returns:float the parsed value Exceptions NumberFormatException: if the string can not be parsed successfully NullPointerException: if the string is null

public static float parseFloat(CharSequence str) throws NumberFormatException

Convenience method for calling parseFloat(CharSequence, int, int).

Parameters

str:CharSequence: the string to be parsed

Returns:float

the parsed value

Exceptions

NumberFormatException:: if the string can not be parsed successfully
NullPointerException:: if the string is null

parseFloat back to summary

parseFloat	back to summary
public static float parseFloat(CharSequence str, int offset, int length) throws NumberFormatException Parses a `FloatingPointLiteral` from a `CharSequence` and converts it into a `float` value. Parameters str:CharSequence the string to be parsed offset:int the start offset of the `FloatingPointLiteral` in `str` length:int the length of `FloatingPointLiteral` in `str` Returns:float the parsed value Exceptions NumberFormatException: if the string can not be parsed successfully NullPointerException: if the string is null IllegalArgumentException: if offset or length are illegal

public static float parseFloat(CharSequence str, int offset, int length) throws NumberFormatException

Parses a FloatingPointLiteral from a CharSequence and converts it into a float value.

Parameters

str:CharSequence: the string to be parsed
offset:int: the start offset of the FloatingPointLiteral in str
length:int: the length of FloatingPointLiteral in str

Returns:float

the parsed value

Exceptions

NumberFormatException:: if the string can not be parsed successfully
NullPointerException:: if the string is null
IllegalArgumentException:: if offset or length are illegal

parseFloat back to summary

parseFloat	back to summary
public static float parseFloat(byte[] str) throws NumberFormatException Convenience method for calling `parseFloat(byte[], int, int)`. Parameters str:byte[] the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding Returns:float the parsed value Exceptions NumberFormatException: if the string can not be parsed successfully NullPointerException: if the string is null

public static float parseFloat(byte[] str) throws NumberFormatException

Convenience method for calling parseFloat(byte[], int, int).

Parameters

str:byte[]: the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding

Returns:float

the parsed value

Exceptions

NumberFormatException:: if the string can not be parsed successfully
NullPointerException:: if the string is null

parseFloat back to summary

parseFloat	back to summary
public static float parseFloat(byte[] str, int offset, int length) throws NumberFormatException Parses a `FloatingPointLiteral` from a `byte`-Array and converts it into a `float` value. Parameters str:byte[] the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding offset:int The index of the first byte to parse length:int The number of bytes to parse Returns:float the parsed value Exceptions NumberFormatException: if the string can not be parsed successfully NullPointerException: if the string is null IllegalArgumentException: if offset or length are illegal

public static float parseFloat(byte[] str, int offset, int length) throws NumberFormatException

Parses a FloatingPointLiteral from a byte-Array and converts it into a float value.

Parameters

str:byte[]: the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding
offset:int: The index of the first byte to parse
length:int: The number of bytes to parse

Returns:float

the parsed value

Exceptions

NumberFormatException:: if the string can not be parsed successfully
NullPointerException:: if the string is null
IllegalArgumentException:: if offset or length are illegal

parseFloat back to summary

parseFloat	back to summary
public static float parseFloat(char[] str) throws NumberFormatException Convenience method for calling `parseFloat(char[], int, int)`. Parameters str:char[] the string to be parsed Returns:float the parsed value Exceptions NumberFormatException: if the string can not be parsed successfully NullPointerException: if the string is null

public static float parseFloat(char[] str) throws NumberFormatException

Convenience method for calling parseFloat(char[], int, int).

Parameters

str:char[]: the string to be parsed

Returns:float

the parsed value

Exceptions

NumberFormatException:: if the string can not be parsed successfully
NullPointerException:: if the string is null

parseFloat back to summary

parseFloat	back to summary
public static float parseFloat(char[] str, int offset, int length) throws NumberFormatException Parses a `FloatingPointLiteral` from a `byte`-Array and converts it into a `float` value. Parameters str:char[] the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding offset:int The index of the first character to parse length:int The number of characters to parse Returns:float the parsed value Exceptions NumberFormatException: if the string can not be parsed successfully NullPointerException: if the string is null IllegalArgumentException: if offset or length are illegal

public static float parseFloat(char[] str, int offset, int length) throws NumberFormatException

Parses a FloatingPointLiteral from a byte-Array and converts it into a float value.

Parameters

str:char[]: the string to be parsed, a byte array with characters in ISO-8859-1, ASCII or UTF-8 encoding
offset:int: The index of the first character to parse
length:int: The number of characters to parse

Returns:float

the parsed value

Exceptions

NumberFormatException:: if the string can not be parsed successfully
NullPointerException:: if the string is null
IllegalArgumentException:: if offset or length are illegal

public Class JavaFloatParser

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail