com.fasterxml.jackson.core.io

Class NumberInput

java.lang.Object

com.fasterxml.jackson.core.io.NumberInput

public final class NumberInput
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	NASTY_SMALL_DOUBLE Textual representation of a double constant that can cause nasty problems with JDK (see http://www.exploringbinary.com/java-hangs-when-converting-2-2250738585072012e-308).

Constructor Summary

Constructors

Constructor and Description
NumberInput()

Method Summary

Modifier and Type	Method and Description
static boolean	inLongRange(char[] ch, int off, int len, boolean negative) Helper method for determining if given String representation of an integral number would fit in 64-bit Java long or not.
static boolean	inLongRange(String s, boolean negative) Similar to inLongRange(char[],int,int,boolean), but with String argument
static double	parseAsDouble(String s, double def)
static int	parseAsInt(String s, int def)
static long	parseAsLong(String s, long def)
static BigDecimal	parseBigDecimal(char[] ch)
static BigDecimal	parseBigDecimal(char[] ch, int off, int len)
static BigDecimal	parseBigDecimal(String s)
static double	parseDouble(String s)
static int	parseInt(char[] ch, int off, int len) Fast method for parsing unsigned integers that are known to fit into regular 32-bit signed int type.
static int	parseInt(String s) Helper method to (more) efficiently parse integer numbers from String values.
static long	parseLong(char[] ch, int off, int len)
static long	parseLong(String s) Similar to parseInt(String) but for long values.

Methods inherited from class java.lang.Object

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

Field Detail

NASTY_SMALL_DOUBLE

public static final String NASTY_SMALL_DOUBLE

Textual representation of a double constant that can cause nasty problems with JDK (see http://www.exploringbinary.com/java-hangs-when-converting-2-2250738585072012e-308).

See Also:

Constant Field Values

Constructor Detail

NumberInput

public NumberInput()

Method Detail

parseInt

public static int parseInt(char[] ch,
                           int off,
                           int len)

Fast method for parsing unsigned integers that are known to fit into regular 32-bit signed int type. This means that length is between 1 and 9 digits (inclusive) and there is no sign character.

Note: public to let unit tests call it; not meant to be used by any code outside this package.

Parameters:

ch - Buffer that contains integer value to decode

off - Offset of the first digit character in buffer

len - Length of the number to decode (in characters)

Returns:

Decoded int value

parseInt

public static int parseInt(String s)

Helper method to (more) efficiently parse integer numbers from String values. Input String must be simple Java integer value. No range checks are made to verify that the value fits in 32-bit Java int: caller is expected to only calls this in cases where this can be guaranteed (basically: number of digits does not exceed 9)

NOTE: semantics differ significantly from parseInt(char[], int, int).

Parameters:

s - String that contains integer value to decode

Returns:

Decoded int value

parseLong

public static long parseLong(char[] ch,
                             int off,
                             int len)

parseLong

public static long parseLong(String s)

Similar to parseInt(String) but for long values.

Parameters:

s - String that contains long value to decode

Returns:

Decoded long value

inLongRange

public static boolean inLongRange(char[] ch,
                                  int off,
                                  int len,
                                  boolean negative)

Helper method for determining if given String representation of an integral number would fit in 64-bit Java long or not. Note that input String must NOT contain leading minus sign (even if 'negative' is set to true).

Parameters:

ch - Buffer that contains long value to check

off - Offset of the first digit character in buffer

len - Length of the number to decode (in characters)

negative - Whether original number had a minus sign (which is NOT passed to this method) or not

Returns:

True if specified String representation is within Java long range; false if not.

inLongRange

public static boolean inLongRange(String s,
                                  boolean negative)

Similar to inLongRange(char[],int,int,boolean), but with String argument

Parameters:

s - String that contains long value to check

negative - Whether original number had a minus sign (which is NOT passed to this method) or not

Returns:

True if specified String representation is within Java long range; false if not.

parseAsInt

public static int parseAsInt(String s,
                             int def)

parseAsLong

public static long parseAsLong(String s,
                               long def)

parseAsDouble

public static double parseAsDouble(String s,
                                   double def)

parseDouble

public static double parseDouble(String s)
                          throws NumberFormatException

Throws:

NumberFormatException

parseBigDecimal

public static BigDecimal parseBigDecimal(String s)
                                  throws NumberFormatException

Throws:

NumberFormatException

parseBigDecimal

public static BigDecimal parseBigDecimal(char[] ch,
                                         int off,
                                         int len)
                                  throws NumberFormatException

Throws:

NumberFormatException

parseBigDecimal

public static BigDecimal parseBigDecimal(char[] ch)
                                  throws NumberFormatException

Throws:

NumberFormatException