com.phloc.commons.string

Class StringParser

java.lang.Object

com.phloc.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

Methods

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