Module ch.randelshofer.fastdoubleparser

Package ch.randelshofer.fastdoubleparser

Class JavaBigIntegerParser

java.lang.Object

ch.randelshofer.fastdoubleparser.JavaBigIntegerParser

public class JavaBigIntegerParser
extends Object

Parses a BigInteger value; the supported syntax is a super-set of the syntax supported by BigInteger(String).

Syntax

Formal specification of the grammar:

BigIntegerLiteral:

[Sign] Digits

[Sign] 0x [HexDigits]

[Sign] 0X [HexDigits]

Digits:

Digit {Digit}

HexDigits:

HexDigit {HexDigit}

Digit:

(one of)

0 1 2 3 4 5 6 7 8 9

HexDigit:

(one of)

0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F

Character lengths accepted by BigInteger(String):

• Significand: 1 to 1,292,782,621 decimal digits.

  The resulting value must fit into 2^31 - 1 bits. The decimal representation of the value 2^31 - 1 has 646,456,993 digits. Therefore an input String can only contain up to that many significant digits - the remaining digits must be leading zeroes.

Method Summary

Modifier and Type	Method	Description
static BigInteger	parallelParseBigInteger(byte[] str)	Convenience method for calling parallelParseBigInteger(byte[], int, int).
static BigInteger	parallelParseBigInteger(byte[] str, int offset, int length)	Parses a BigIntegerLiteral from a byte-Array and converts it into a BigInteger value.
static BigInteger	parallelParseBigInteger(char[] str)	Convenience method for calling parallelParseBigInteger(char[], int, int).
static BigInteger	parallelParseBigInteger(char[] str, int offset, int length)	Parses a BigIntegerLiteral from a char-Array and converts it into a BigInteger value.
static BigInteger	parallelParseBigInteger(CharSequence str)	Convenience method for calling parallelParseBigInteger(CharSequence, int, int).
static BigInteger	parallelParseBigInteger(CharSequence str, int offset, int length)	Convenience method for calling parallelParseBigInteger(byte[], int, int).
static BigInteger	parseBigInteger(byte[] str)	Convenience method for calling parseBigInteger(byte[], int, int).
static BigInteger	parseBigInteger(byte[] str, int offset, int length)	Parses a BigIntegerLiteral from a byte-Array and converts it into a BigInteger value.
static BigInteger	parseBigInteger(char[] str)	Convenience method for calling parseBigInteger(char[], int, int).
static BigInteger	parseBigInteger(char[] str, int offset, int length)	Parses a BigIntegerLiteral from a char-Array and converts it into a BigInteger value.
static BigInteger	parseBigInteger(CharSequence str)	Convenience method for calling parseBigInteger(CharSequence, int, int).
static BigInteger	parseBigInteger(CharSequence str, int offset, int length)	Convenience method for calling parseBigInteger(byte[], int, int).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

parseBigInteger

public static BigInteger parseBigInteger(CharSequence str)

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

Parameters:

str - the string to be parsed

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

NumberFormatException - if the string can not be parsed successfully

parseBigInteger

public static BigInteger parseBigInteger(CharSequence str,
 int offset,
 int length)

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

Parameters:

str - the string to be parsed

offset - The index of the first character to parse

length - The number of characters to parse

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

IllegalArgumentException - if offset or length are illegal

NumberFormatException - if the string can not be parsed successfully

parseBigInteger

public static BigInteger parseBigInteger(byte[] str)

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

Parameters:

str - the string to be parsed

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

NumberFormatException - if the string can not be parsed successfully

parseBigInteger

public static BigInteger parseBigInteger(byte[] str,
 int offset,
 int length)

Parses a BigIntegerLiteral from a byte-Array and converts it into a BigInteger value.

See JsonDoubleParser for the syntax of FloatingPointLiteral.

Parameters:

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

offset - The index of the first character to parse

length - The number of characters to parse

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

IllegalArgumentException - if offset or length are illegal

NumberFormatException - if the string can not be parsed successfully

parseBigInteger

public static BigInteger parseBigInteger(char[] str)

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

Parameters:

str - the string to be parsed

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

NumberFormatException - if the string can not be parsed successfully

parseBigInteger

public static BigInteger parseBigInteger(char[] str,
 int offset,
 int length)

Parses a BigIntegerLiteral from a char-Array and converts it into a BigInteger value.

See JsonDoubleParser for the syntax of FloatingPointLiteral.

Parameters:

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

offset - The index of the first character to parse

length - The number of characters to parse

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

IllegalArgumentException - if offset or length are illegal

NumberFormatException - if the string can not be parsed successfully

parallelParseBigInteger

public static BigInteger parallelParseBigInteger(CharSequence str)

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

Parameters:

str - the string to be parsed

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

NumberFormatException - if the string can not be parsed successfully

parallelParseBigInteger

public static BigInteger parallelParseBigInteger(CharSequence str,
 int offset,
 int length)

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

Parameters:

str - the string to be parsed

offset - The index of the first character to parse

length - The number of characters to parse

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

IllegalArgumentException - if offset or length are illegal

NumberFormatException - if the string can not be parsed successfully

parallelParseBigInteger

public static BigInteger parallelParseBigInteger(byte[] str)

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

Parameters:

str - the string to be parsed

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

NumberFormatException - if the string can not be parsed successfully

parallelParseBigInteger

public static BigInteger parallelParseBigInteger(byte[] str,
 int offset,
 int length)

Parses a BigIntegerLiteral from a byte-Array and converts it into a BigInteger value.

See JsonDoubleParser for the syntax of FloatingPointLiteral.

Parameters:

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

offset - The index of the first character to parse

length - The number of characters to parse

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

IllegalArgumentException - if offset or length are illegal

NumberFormatException - if the string can not be parsed successfully

parallelParseBigInteger

public static BigInteger parallelParseBigInteger(char[] str)

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

Parameters:

str - the string to be parsed

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

NumberFormatException - if the string can not be parsed successfully

parallelParseBigInteger

public static BigInteger parallelParseBigInteger(char[] str,
 int offset,
 int length)

Parses a BigIntegerLiteral from a char-Array and converts it into a BigInteger value.

See JsonDoubleParser for the syntax of FloatingPointLiteral.

Parameters:

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

offset - The index of the first character to parse

length - The number of characters to parse

Returns:

the parsed value

Throws:

NullPointerException - if the string is null

IllegalArgumentException - if offset or length are illegal

NumberFormatException - if the string can not be parsed successfully