com.helger.commons.string

Class StringParser

java.lang.Object

com.helger.commons.string.StringParser

@Immutable
public final class StringParser
extends Object

This class contains the methods to parse String objects to numeric values. Before v3.7.0 this was contained in class StringHelper.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_RADIX The default radix used to convert string values to numeric values

Method Summary

Modifier and Type	Method and Description
static boolean	isDouble(String sStr) Checks if the given string is a double string that can be converted to a double value.
static boolean	isFloat(String sStr) Checks if the given string is a float string that can be converted to a double value.
static boolean	isInt(String sStr) Checks if the given string is a numeric string that can be converted to a long value with radix 10.
static boolean	isLong(String sStr) Checks if the given string is a numeric string that can be converted to a long value with radix 10.
static boolean	isUnsignedInt(String sStr) Checks if the given string is a numeric string that can be converted to an unsigned long value with radix 10.
static boolean	isUnsignedLong(String sStr) Checks if the given string is a numeric string that can be converted to an unsigned long value with radix 10.
static BigDecimal	parseBigDecimal(String sStr) Parse the given String as BigDecimal.
static BigDecimal	parseBigDecimal(String sStr, BigDecimal aDefault) Parse the given String as BigDecimal.
static BigDecimal	parseBigDecimal(String sStr, int nScale, RoundingMode eRoundingMode) Parse the given String as BigDecimal.
static BigDecimal	parseBigDecimal(String sStr, int nScale, RoundingMode eRoundingMode, BigDecimal aDefault) Parse the given String as BigDecimal.
static BigInteger	parseBigInteger(String sStr) Parse the given String as BigInteger with radix 10.
static BigInteger	parseBigInteger(String sStr, BigInteger aDefault) Parse the given String as BigInteger with radix 10.
static BigInteger	parseBigInteger(String sStr, int nRadix) Parse the given String as BigInteger with the specified radix.
static BigInteger	parseBigInteger(String sStr, int nRadix, BigInteger aDefault) Parse the given String as BigInteger with the specified radix.
static boolean	parseBool(Object aObject) Try to interpret the passed object as boolean.
static boolean	parseBool(Object aObject, boolean bDefault) Try to interpret the passed object as boolean.
static boolean	parseBool(String sStr) Parse the given String as boolean value.
static boolean	parseBool(String sStr, boolean bDefault) Parse the given String as boolean value.
static Boolean	parseBoolObj(Object aObject) Try to interpret the passed object as boolean.
static Boolean	parseBoolObj(Object aObject, Boolean aDefault) Try to interpret the passed Object as Boolean.
static Boolean	parseBoolObj(String sStr) Returns a Boolean with a value represented by the specified string.
static Boolean	parseBoolObjExact(String sStr) Returns a Boolean with a value represented by the specified string.
static Boolean	parseBoolObjExact(String sStr, Boolean aDefault) Returns a Boolean with a value represented by the specified string.
static byte	parseByte(Object aObject, byte nDefault) Parse the given Object as byte with radix 10.
static byte	parseByte(Object aObject, int nRadix, byte nDefault) Parse the given Object as byte with the specified radix.
static byte	parseByte(String sStr, byte nDefault) Parse the given String as byte with radix 10.
static byte	parseByte(String sStr, int nRadix, byte nDefault) Parse the given String as byte with the specified radix.
static Byte	parseByteObj(Object aObject) Parse the given Object as Byte with radix 10.
static Byte	parseByteObj(Object aObject, Byte aDefault) Parse the given Object as Byte with radix 10.
static Byte	parseByteObj(Object aObject, int nRadix, Byte aDefault) Parse the given Object as Byte with the specified radix.
static Byte	parseByteObj(String sStr) Parse the given String as Byte with radix 10.
static Byte	parseByteObj(String sStr, Byte aDefault) Parse the given String as Byte with radix 10.
static Byte	parseByteObj(String sStr, int nRadix, Byte aDefault) Parse the given String as Byte with the specified radix.
static double	parseDouble(Object aObject, double dDefault) Parse the given Object as double.
static double	parseDouble(String sStr, double dDefault) Parse the given String as double.
static Double	parseDoubleObj(Object aObject) Parse the given Object as Double.
static Double	parseDoubleObj(Object aObject, Double aDefault) Parse the given Object as Double.
static Double	parseDoubleObj(String sStr) Parse the given String as Double.
static Double	parseDoubleObj(String sStr, Double aDefault) Parse the given String as Double.
static float	parseFloat(Object aObject, float fDefault) Parse the given Object as float.
static float	parseFloat(String sStr, float fDefault) Parse the given String as float.
static Float	parseFloatObj(Object aObject) Parse the given Object as Float.
static Float	parseFloatObj(Object aObject, Float aDefault) Parse the given Object as Float.
static Float	parseFloatObj(String sStr) Parse the given String as Float.
static Float	parseFloatObj(String sStr, Float aDefault) Parse the given String as Float.
static int	parseInt(Object aObject, int nDefault) Parse the given Object as int with radix DEFAULT_RADIX.
static int	parseInt(Object aObject, int nRadix, int nDefault) Parse the given Object as int with the specified radix.
static int	parseInt(String sStr, int nDefault) Parse the given String as int with radix 10.
static int	parseInt(String sStr, int nRadix, int nDefault) Parse the given String as int with the specified radix.
static Integer	parseIntObj(Object aObject) Parse the given Object as Integer with radix 10.
static Integer	parseIntObj(Object aObject, Integer aDefault) Parse the given Object as Integer with radix 10.
static Integer	parseIntObj(Object aObject, int nRadix, Integer aDefault) Parse the given Object as Integer with the specified radix.
static Integer	parseIntObj(String sStr) Parse the given String as Integer with radix 10.
static Integer	parseIntObj(String sStr, Integer aDefault) Parse the given String as Integer with radix DEFAULT_RADIX.
static Integer	parseIntObj(String sStr, int nRadix, Integer aDefault) Parse the given String as Integer with the specified radix.
static long	parseLong(Object aObject, int nRadix, long nDefault) Parse the given Object as long with the specified radix.
static long	parseLong(Object aObject, long nDefault) Parse the given Object as long with radix 10.
static long	parseLong(String sStr, int nRadix, long nDefault) Parse the given String as long with the specified radix.
static long	parseLong(String sStr, long nDefault) Parse the given String as long with radix 10.
static Long	parseLongObj(Object aObject) Parse the given Object as Long with radix 10.
static Long	parseLongObj(Object aObject, int nRadix, Long aDefault) Parse the given Object as Long with the specified radix.
static Long	parseLongObj(Object aObject, Long aDefault) Parse the given Object as Long with radix 10.
static Long	parseLongObj(String sStr) Parse the given String as Long with radix 10.
static Long	parseLongObj(String sStr, int nRadix, Long aDefault) Parse the given String as Long with the specified radix.
static Long	parseLongObj(String sStr, Long aDefault) Parse the given String as Long with radix DEFAULT_RADIX.
static short	parseShort(Object aObject, int nRadix, short nDefault) Parse the given Object as short with the specified radix.
static short	parseShort(Object aObject, short nDefault) Parse the given Object as short with radix 10.
static short	parseShort(String sStr, int nRadix, short nDefault) Parse the given String as short with the specified radix.
static short	parseShort(String sStr, short nDefault) Parse the given String as short with radix 10.
static Short	parseShortObj(Object aObject) Parse the given Object as Short with radix 10.
static Short	parseShortObj(Object aObject, int nRadix, Short aDefault) Parse the given Object as Short with the specified radix.
static Short	parseShortObj(Object aObject, Short aDefault) Parse the given Object as Short with radix 10.
static Short	parseShortObj(String sStr) Parse the given String as Short with radix 10.
static Short	parseShortObj(String sStr, int nRadix, Short aDefault) Parse the given String as Short with the specified radix.
static Short	parseShortObj(String sStr, Short aDefault) Parse the given String as Short with radix DEFAULT_RADIX.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_RADIX

public static final int DEFAULT_RADIX

The default radix used to convert string values to numeric values

See Also:

Constant Field Values

Method Detail

parseBool

public static boolean parseBool(@Nullable
                                Object aObject)

Try to interpret the passed object as boolean. This works only if the passed object is either a String or a Boolean.

Parameters:

aObject - The object to be interpreted. May be null.

Returns:

false if the passed object cannot be interpreted as a boolean.

parseBool

public static boolean parseBool(@Nullable
                                Object aObject,
                                boolean bDefault)

Try to interpret the passed object as boolean. This works only if the passed object is either a String or a Boolean.

Parameters:

aObject - The object to be interpreted. May be null.

bDefault - The default value to be returned, if the object cannot be interpreted.

Returns:

The boolean representation or the default value if the passed object cannot be interpreted as a boolean.

parseBool

public static boolean parseBool(@Nullable
                                String sStr)

Parse the given String as boolean value. All values that are equal to "true" (ignoring case) will result in true return values. All other values result in false return values. This method is equal to Boolean.parseBoolean(String)

Parameters:

sStr - The string to be interpreted. May be null.

Returns:

true if the passed string matches "true" (ignoring case), false otherwise.

See Also:

Boolean.parseBoolean(String)

parseBool

public static boolean parseBool(@Nullable
                                String sStr,
                                boolean bDefault)

Parse the given String as boolean value. All values that are equal to "true" (ignoring case) will result in true return values. All values that are equal to "false" (ignoring case) will result in false return values. All other values will return the default.

Parameters:

sStr - The string to be interpreted. May be null.

bDefault - The default value to be returned if the passed string is neither "true" nor "false".

Returns:

true or false :)

parseBoolObj

@Nullable
public static Boolean parseBoolObj(@Nullable
                                              Object aObject)

Try to interpret the passed object as boolean. This works only if the passed object is either a String or a Boolean.

Parameters:

aObject - The object to be interpreted. May be null.

Returns:

null if the passed object cannot be interpreted as a boolean, any other Boolean otherwise.

parseBoolObj

@Nullable
public static Boolean parseBoolObj(@Nullable
                                              Object aObject,
                                              @Nullable
                                              Boolean aDefault)

Try to interpret the passed Object as Boolean.

Parameters:

aObject - The object to be interpreted. May be null.

aDefault - The default value to be returned, if the passed object is null.

Returns:

The passed default value if the passed object is null, the matching Boolean otherwise.

parseBoolObj

@Nonnull
public static Boolean parseBoolObj(@Nullable
                                             String sStr)

Returns a Boolean with a value represented by the specified string. The Boolean returned represents a true value if the string argument is not null and is equal, ignoring case, to the string "true". This method is equal to Boolean.valueOf(String)

Parameters:

sStr - The string to be parsed. May be null.

Returns:

the Boolean value represented by the string. Never null.

parseBoolObjExact

@Nullable
public static Boolean parseBoolObjExact(@Nullable
                                                   String sStr)

Returns a Boolean with a value represented by the specified string. The Boolean returned represents a true value if the string argument is not null and is equal, ignoring case, to the string "true", and it will return false if the string argument is not null and is equal, ignoring case, to the string "false". In all other cases null is returned.

Parameters:

sStr - The string to be parsed. May be null.

Returns:

the Boolean value represented by the string. Never null.

parseBoolObjExact

@Nullable
public static Boolean parseBoolObjExact(@Nullable
                                                   String sStr,
                                                   @Nullable
                                                   Boolean aDefault)

Returns a Boolean with a value represented by the specified string. The Boolean returned represents a true value if the string argument is not null and is equal, ignoring case, to the string "true", and it will return false if the string argument is not null and is equal, ignoring case, to the string "false". In all other cases aDefault is returned.

Parameters:

sStr - The string to be parsed. May be null.

aDefault - The default value to be returned if the value is neither "true" nor "false". May be null.

Returns:

the Boolean value represented by the string. Never null.

parseByte

public static byte parseByte(@Nullable
                             Object aObject,
                             byte nDefault)

Parse the given Object as byte with radix 10.

Parameters:

aObject - The Object to parse. May be null.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the string does not represent a valid value.

parseByte

public static byte parseByte(@Nullable
                             Object aObject,
                             @Nonnegative
                             int nRadix,
                             byte nDefault)

Parse the given Object as byte with the specified radix.

Parameters:

aObject - The Object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the string does not represent a valid value.

parseByte

public static byte parseByte(@Nullable
                             String sStr,
                             byte nDefault)

Parse the given String as byte with radix 10.

Parameters:

sStr - The String to parse. May be null.

nDefault - The value to be returned if the string cannot be converted to a valid value.

Returns:

The passed default parameter if the string does not represent a valid value.

parseByte

public static byte parseByte(@Nullable
                             String sStr,
                             @Nonnegative
                             int nRadix,
                             byte nDefault)

Parse the given String as byte with the specified radix.

Parameters:

sStr - The String to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The value to be returned if the string cannot be converted to a valid value.

Returns:

The passed default parameter if the string does not represent a valid value.

parseByteObj

@Nullable
public static Byte parseByteObj(@Nullable
                                           Object aObject)

Parse the given Object as Byte with radix 10.

Parameters:

aObject - The object to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseByteObj

@Nullable
public static Byte parseByteObj(@Nullable
                                           Object aObject,
                                           @Nullable
                                           Byte aDefault)

Parse the given Object as Byte with radix 10.

Parameters:

aObject - The object to parse. May be null.

aDefault - The default value to be returned, if the passed object cannot be converted. May be null.

Returns:

the passed default value if the object does not represent a valid value.

parseByteObj

@Nullable
public static Byte parseByteObj(@Nullable
                                           Object aObject,
                                           @Nonnegative
                                           int nRadix,
                                           @Nullable
                                           Byte aDefault)

Parse the given Object as Byte with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned, if the passed object cannot be converted. May be null.

Returns:

the passed default value if the object does not represent a valid value.

parseByteObj

@Nullable
public static Byte parseByteObj(@Nullable
                                           String sStr)

Parse the given String as Byte with radix 10.

Parameters:

sStr - The String to parse. May be null.

Returns:

null if the string does not represent a valid value.

parseByteObj

@Nullable
public static Byte parseByteObj(@Nullable
                                           String sStr,
                                           @Nullable
                                           Byte aDefault)

Parse the given String as Byte with radix 10.

Parameters:

sStr - The String to parse. May be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseByteObj

@Nullable
public static Byte parseByteObj(@Nullable
                                           String sStr,
                                           @Nonnegative
                                           int nRadix,
                                           @Nullable
                                           Byte aDefault)

Parse the given String as Byte with the specified radix.

Parameters:

sStr - The String to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseDouble

public static double parseDouble(@Nullable
                                 Object aObject,
                                 double dDefault)

Parse the given Object as double. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

aObject - The object to parse. May be null.

dDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the object does not represent a valid value.

parseDouble

public static double parseDouble(@Nullable
                                 String sStr,
                                 double dDefault)

Parse the given String as double.

Parameters:

sStr - The string to parse. May be null.

dDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the string does not represent a valid value.

parseDoubleObj

@Nullable
public static Double parseDoubleObj(@Nullable
                                               Object aObject)

Parse the given Object as Double. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

aObject - The object to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseDoubleObj

@Nullable
public static Double parseDoubleObj(@Nullable
                                               Object aObject,
                                               @Nullable
                                               Double aDefault)

Parse the given Object as Double. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

aObject - The object to parse. May be null.

aDefault - The default value to be returned if the parsed object cannot be converted to a double. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseDoubleObj

@Nullable
public static Double parseDoubleObj(@Nullable
                                               String sStr)

Parse the given String as Double. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

sStr - The string to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseDoubleObj

@Nullable
public static Double parseDoubleObj(@Nullable
                                               String sStr,
                                               @Nullable
                                               Double aDefault)

Parse the given String as Double. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

sStr - The string to parse. May be null.

aDefault - The default value to be returned if the parsed string cannot be converted to a double. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseFloat

public static float parseFloat(@Nullable
                               Object aObject,
                               float fDefault)

Parse the given Object as float. Note: both the locale independent form of a float can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

aObject - The object to parse. May be null.

fDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the object does not represent a valid value.

parseFloat

public static float parseFloat(@Nullable
                               String sStr,
                               float fDefault)

Parse the given String as float.

Parameters:

sStr - The string to parse. May be null.

fDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the string does not represent a valid value.

parseFloatObj

@Nullable
public static Float parseFloatObj(@Nullable
                                             Object aObject)

Parse the given Object as Float. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

aObject - The object to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseFloatObj

@Nullable
public static Float parseFloatObj(@Nullable
                                             Object aObject,
                                             @Nullable
                                             Float aDefault)

Parse the given Object as Float. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

aObject - The object to parse. May be null.

aDefault - The default value to be returned if the parsed object cannot be converted to a float. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseFloatObj

@Nullable
public static Float parseFloatObj(@Nullable
                                             String sStr)

Parse the given String as Float. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

sStr - The string to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseFloatObj

@Nullable
public static Float parseFloatObj(@Nullable
                                             String sStr,
                                             @Nullable
                                             Float aDefault)

Parse the given String as Float. Note: both the locale independent form of a double can be parsed here (e.g. 4.523) as well as a localized form using the comma as the decimal separator (e.g. the German 4,523).

Parameters:

sStr - The string to parse. May be null.

aDefault - The default value to be returned if the parsed string cannot be converted to a float. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseInt

public static int parseInt(@Nullable
                           Object aObject,
                           int nDefault)

Parse the given Object as int with radix DEFAULT_RADIX.

Parameters:

aObject - The Object to parse. May be null.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the string does not represent a valid value.

parseInt

public static int parseInt(@Nullable
                           Object aObject,
                           @Nonnegative
                           int nRadix,
                           int nDefault)

Parse the given Object as int with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the string does not represent a valid value.

parseInt

public static int parseInt(@Nullable
                           String sStr,
                           int nDefault)

Parse the given String as int with radix 10.

Parameters:

sStr - The String to parse. May be null.

nDefault - The value to be returned if the string cannot be converted to a valid value.

Returns:

The passed default parameter if the string does not represent a valid value.

parseInt

public static int parseInt(@Nullable
                           String sStr,
                           @Nonnegative
                           int nRadix,
                           int nDefault)

Parse the given String as int with the specified radix.

Parameters:

sStr - The String to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The value to be returned if the string cannot be converted to a valid value.

Returns:

The passed default parameter if the string does not represent a valid value.

parseIntObj

@Nullable
public static Integer parseIntObj(@Nullable
                                             Object aObject)

Parse the given Object as Integer with radix 10.

Parameters:

aObject - The object to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseIntObj

@Nullable
public static Integer parseIntObj(@Nullable
                                             Object aObject,
                                             @Nullable
                                             Integer aDefault)

Parse the given Object as Integer with radix 10.

Parameters:

aObject - The object to parse. May be null.

aDefault - The default value to be returned if the passed object cannot be converted to an Integer. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseIntObj

@Nullable
public static Integer parseIntObj(@Nullable
                                             Object aObject,
                                             @Nonnegative
                                             int nRadix,
                                             @Nullable
                                             Integer aDefault)

Parse the given Object as Integer with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed object cannot be converted to an Integer. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseIntObj

@Nullable
public static Integer parseIntObj(@Nullable
                                             String sStr)

Parse the given String as Integer with radix 10.

Parameters:

sStr - The string to parse. May be null.

Returns:

null if the string does not represent a valid value.

parseIntObj

@Nullable
public static Integer parseIntObj(@Nullable
                                             String sStr,
                                             @Nullable
                                             Integer aDefault)

Parse the given String as Integer with radix DEFAULT_RADIX.

Parameters:

sStr - The string to parse. May be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseIntObj

@Nullable
public static Integer parseIntObj(@Nullable
                                             String sStr,
                                             @Nonnegative
                                             int nRadix,
                                             @Nullable
                                             Integer aDefault)

Parse the given String as Integer with the specified radix.

Parameters:

sStr - The string to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseLong

public static long parseLong(@Nullable
                             Object aObject,
                             long nDefault)

Parse the given Object as long with radix 10.

Parameters:

aObject - The object to parse. May be null.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the object does not represent a valid value.

parseLong

public static long parseLong(@Nullable
                             Object aObject,
                             @Nonnegative
                             int nRadix,
                             long nDefault)

Parse the given Object as long with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the object does not represent a valid value.

parseLong

public static long parseLong(@Nullable
                             String sStr,
                             long nDefault)

Parse the given String as long with radix 10.

Parameters:

sStr - The string to parse. May be null.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default if the string does not represent a valid value.

parseLong

public static long parseLong(@Nullable
                             String sStr,
                             @Nonnegative
                             int nRadix,
                             long nDefault)

Parse the given String as long with the specified radix.

Parameters:

sStr - The string to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default if the string does not represent a valid value.

parseLongObj

@Nullable
public static Long parseLongObj(@Nullable
                                           Object aObject)

Parse the given Object as Long with radix 10.

Parameters:

aObject - The object to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseLongObj

@Nullable
public static Long parseLongObj(@Nullable
                                           Object aObject,
                                           @Nullable
                                           Long aDefault)

Parse the given Object as Long with radix 10.

Parameters:

aObject - The object to parse. May be null.

aDefault - The default value to be returned if the passed object cannot be converted to a Long. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseLongObj

@Nullable
public static Long parseLongObj(@Nullable
                                           Object aObject,
                                           @Nonnegative
                                           int nRadix,
                                           @Nullable
                                           Long aDefault)

Parse the given Object as Long with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed object cannot be converted to a Long. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseLongObj

@Nullable
public static Long parseLongObj(@Nullable
                                           String sStr)

Parse the given String as Long with radix 10.

Parameters:

sStr - The string to parse. May be null.

Returns:

null if the string does not represent a valid value.

parseLongObj

@Nullable
public static Long parseLongObj(@Nullable
                                           String sStr,
                                           @Nullable
                                           Long aDefault)

Parse the given String as Long with radix DEFAULT_RADIX.

Parameters:

sStr - The string to parse. May be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseLongObj

@Nullable
public static Long parseLongObj(@Nullable
                                           String sStr,
                                           @Nonnegative
                                           int nRadix,
                                           @Nullable
                                           Long aDefault)

Parse the given String as Long with the specified radix.

Parameters:

sStr - The string to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseShort

public static short parseShort(@Nullable
                               Object aObject,
                               short nDefault)

Parse the given Object as short with radix 10.

Parameters:

aObject - The object to parse. May be null.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the object does not represent a valid value.

parseShort

public static short parseShort(@Nullable
                               Object aObject,
                               @Nonnegative
                               int nRadix,
                               short nDefault)

Parse the given Object as short with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default value if the object does not represent a valid value.

parseShort

public static short parseShort(@Nullable
                               String sStr,
                               short nDefault)

Parse the given String as short with radix 10.

Parameters:

sStr - The string to parse. May be null.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default if the string does not represent a valid value.

parseShort

public static short parseShort(@Nullable
                               String sStr,
                               @Nonnegative
                               int nRadix,
                               short nDefault)

Parse the given String as short with the specified radix.

Parameters:

sStr - The string to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

nDefault - The default value to be returned if the passed object could not be converted to a valid value.

Returns:

The default if the string does not represent a valid value.

parseShortObj

@Nullable
public static Short parseShortObj(@Nullable
                                             Object aObject)

Parse the given Object as Short with radix 10.

Parameters:

aObject - The object to parse. May be null.

Returns:

null if the object does not represent a valid value.

parseShortObj

@Nullable
public static Short parseShortObj(@Nullable
                                             Object aObject,
                                             @Nullable
                                             Short aDefault)

Parse the given Object as Short with radix 10.

Parameters:

aObject - The object to parse. May be null.

aDefault - The default value to be returned if the passed object cannot be converted to a Short. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseShortObj

@Nullable
public static Short parseShortObj(@Nullable
                                             Object aObject,
                                             @Nonnegative
                                             int nRadix,
                                             @Nullable
                                             Short aDefault)

Parse the given Object as Short with the specified radix.

Parameters:

aObject - The object to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed object cannot be converted to a Short. May be null.

Returns:

aDefault if the object does not represent a valid value.

parseShortObj

@Nullable
public static Short parseShortObj(@Nullable
                                             String sStr)

Parse the given String as Short with radix 10.

Parameters:

sStr - The string to parse. May be null.

Returns:

null if the string does not represent a valid value.

parseShortObj

@Nullable
public static Short parseShortObj(@Nullable
                                             String sStr,
                                             @Nullable
                                             Short aDefault)

Parse the given String as Short with radix DEFAULT_RADIX.

Parameters:

sStr - The string to parse. May be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseShortObj

@Nullable
public static Short parseShortObj(@Nullable
                                             String sStr,
                                             @Nonnegative
                                             int nRadix,
                                             @Nullable
                                             Short aDefault)

Parse the given String as Short with the specified radix.

Parameters:

sStr - The string to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseBigInteger

@Nullable
public static BigInteger parseBigInteger(@Nullable
                                                    String sStr)

Parse the given String as BigInteger with radix 10.

Parameters:

sStr - The String to parse. May be null.

Returns:

null if the string does not represent a valid value.

parseBigInteger

@Nullable
public static BigInteger parseBigInteger(@Nullable
                                                    String sStr,
                                                    @Nonnegative
                                                    int nRadix)

Parse the given String as BigInteger with the specified radix.

Parameters:

sStr - The String to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

Returns:

null if the string does not represent a valid value.

parseBigInteger

@Nullable
public static BigInteger parseBigInteger(@Nullable
                                                    String sStr,
                                                    @Nullable
                                                    BigInteger aDefault)

Parse the given String as BigInteger with radix 10.

Parameters:

sStr - The String to parse. May be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseBigInteger

@Nullable
public static BigInteger parseBigInteger(@Nullable
                                                    String sStr,
                                                    @Nonnegative
                                                    int nRadix,
                                                    @Nullable
                                                    BigInteger aDefault)

Parse the given String as BigInteger with the specified radix.

Parameters:

sStr - The String to parse. May be null.

nRadix - The radix to use. Must be ≥ Character.MIN_RADIX and ≤ Character.MAX_RADIX.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseBigDecimal

@Nullable
public static BigDecimal parseBigDecimal(@Nullable
                                                    String sStr)

Parse the given String as BigDecimal.

Parameters:

sStr - The String to parse. May be null.

Returns:

null if the string does not represent a valid value.

parseBigDecimal

@Nullable
public static BigDecimal parseBigDecimal(@Nullable
                                                    String sStr,
                                                    @Nullable
                                                    BigDecimal aDefault)

Parse the given String as BigDecimal.

Parameters:

sStr - The String to parse. May be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

parseBigDecimal

@Nullable
public static BigDecimal parseBigDecimal(@Nullable
                                                    String sStr,
                                                    @Nonnegative
                                                    int nScale,
                                                    @Nonnull
                                                    RoundingMode eRoundingMode)

Parse the given String as BigDecimal.

Parameters:

sStr - The String to parse. May be null.

nScale - The scaling (decimal places) to be used for the result. Must be ≥ 0!

eRoundingMode - The rounding mode to be used to achieve the scale. May not be null.

Returns:

null if the string does not represent a valid value.

parseBigDecimal

@Nullable
public static BigDecimal parseBigDecimal(@Nullable
                                                    String sStr,
                                                    @Nonnegative
                                                    int nScale,
                                                    @Nonnull
                                                    RoundingMode eRoundingMode,
                                                    @Nullable
                                                    BigDecimal aDefault)

Parse the given String as BigDecimal.

Parameters:

sStr - The String to parse. May be null.

nScale - The scaling (decimal places) to be used for the result. Must be ≥ 0!

eRoundingMode - The rounding mode to be used to achieve the scale. May not be null.

aDefault - The default value to be returned if the passed string could not be converted to a valid value. May be null.

Returns:

aDefault if the string does not represent a valid value.

isInt

public static boolean isInt(@Nullable
                            String sStr)

Checks if the given string is a numeric string that can be converted to a long value with radix 10.

Parameters:

sStr - The string to check. May be null.

Returns:

true if the value can be converted to a valid value

isLong

public static boolean isLong(@Nullable
                             String sStr)

Checks if the given string is a numeric string that can be converted to a long value with radix 10.

Parameters:

sStr - The string to check. May be null.

Returns:

true if the value can be converted to a valid value

isUnsignedInt

public static boolean isUnsignedInt(@Nullable
                                    String sStr)

Checks if the given string is a numeric string that can be converted to an unsigned long value with radix 10.

Parameters:

sStr - The string to check. May be null.

Returns:

true if the value can be converted to a valid value

isUnsignedLong

public static boolean isUnsignedLong(@Nullable
                                     String sStr)

Checks if the given string is a numeric string that can be converted to an unsigned long value with radix 10.

Parameters:

sStr - The string to check. May be null.

Returns:

true if the value can be converted to a valid value

isDouble

public static boolean isDouble(@Nullable
                               String sStr)

Checks if the given string is a double string that can be converted to a double value.

Parameters:

sStr - The string to check. May be null.

Returns:

true if the value can be converted to a valid value

isFloat

public static boolean isFloat(@Nullable
                              String sStr)

Checks if the given string is a float string that can be converted to a double value.

Parameters:

sStr - The string to check. May be null.

Returns:

true if the value can be converted to a valid value