| java.lang.Object
 org.apache.commons.lang.NumberUtils
| NumberUtils | | final public class NumberUtils (Code) | | Provides extra functionality for Java Number classes.
author:
Rand McNeely
author:
Stephen Colebourne
author:
Steve Downey
author:
Eric Pugh
author:
Phil Steitz
since:
1.0
version:
$Id: NumberUtils.java 488819 2006-12-19 21:50:04Z bayard $ |
| Constructor Summary | |
| public | NumberUtils()
NumberUtils instances should NOT be constructed in standard programming.
|
| Method Summary | |
| public static int | compare(double lhs, double rhs)
Compares two doubles for order.
This method is more comprehensive than the standard Java greater
than, less than and equals operators.
- It returns
-1 if the first value is less than the second. | | public static int | compare(float lhs, float rhs)
Compares two floats for order.
This method is more comprehensive than the standard Java greater than,
less than and equals operators.
- It returns
-1 if the first value is less than the second. | | public static BigDecimal | createBigDecimal(String val)
| | public static BigInteger | createBigInteger(String val)
| | public static Double | createDouble(String val)
| | public static Float | createFloat(String val)
| | public static Integer | createInteger(String val)
| | public static Long | createLong(String val)
| | public static Number | createNumber(String val)
Turns a string value into a java.lang.Number.
First, the value is examined for a type qualifier on the end
('f','F','d','D','l','L'). | | public static boolean | isDigits(String str)
| | public static boolean | isNumber(String str)
Checks whether the String a valid Java number.
Valid numbers include hexadecimal marked with the 0x
qualifier, scientific notation and numbers marked with a type
qualifier (e.g. | | public static long | maximum(long a, long b, long c)
| | public static int | maximum(int a, int b, int c)
| | public static long | minimum(long a, long b, long c)
| | public static int | minimum(int a, int b, int c)
| | public static int | stringToInt(String str)
| | public static int | stringToInt(String str, int defaultValue)
|
| NumberUtils | | public NumberUtils()(Code) | | NumberUtils instances should NOT be constructed in standard programming.
Instead, the class should be used as NumberUtils.stringToInt("6");.
This constructor is public to permit tools that require a JavaBean instance
to operate.
|
| compare | | public static int compare(double lhs, double rhs)(Code) | | Compares two doubles for order.
This method is more comprehensive than the standard Java greater
than, less than and equals operators.
- It returns
-1 if the first value is less than the second.
- It returns
+1 if the first value is greater than the second.
- It returns
0 if the values are equal.
The ordering is as follows, largest to smallest:
- NaN
- Positive infinity
- Maximum double
- Normal positive numbers
- +0.0
- -0.0
- Normal negative numbers
- Minimum double (-Double.MAX_VALUE)
- Negative infinity
Comparing NaN with NaN will
return 0.
Parameters:
lhs - the first double
Parameters:
rhs - the second double -1 if lhs is less, +1 if greater,0 if equal to rhs |
| compare | | public static int compare(float lhs, float rhs)(Code) | | Compares two floats for order.
This method is more comprehensive than the standard Java greater than,
less than and equals operators.
- It returns
-1 if the first value is less than the second.
- It returns
+1 if the first value is greater than the second.
- It returns
0 if the values are equal.
The ordering is as follows, largest to smallest:
- NaN
- Positive infinity
- Maximum float
- Normal positive numbers
- +0.0
- -0.0
- Normal negative numbers
- Minimum float (-Float.MAX_VALUE)
- Negative infinity
Comparing NaN with NaN will return
0.
Parameters:
lhs - the first float
Parameters:
rhs - the second float -1 if lhs is less, +1 if greater,0 if equal to rhs |
| createBigDecimal | | public static BigDecimal createBigDecimal(String val)(Code) | | Convert a String to a BigDecimal.
Parameters:
val - a String to convert converted BigDecimal
throws:
NumberFormatException - if the value cannot be converted |
| createBigInteger | | public static BigInteger createBigInteger(String val)(Code) | | Convert a String to a BigInteger.
Parameters:
val - a String to convert converted BigInteger
throws:
NumberFormatException - if the value cannot be converted |
| createDouble | | public static Double createDouble(String val)(Code) | | Convert a String to a Double.
Parameters:
val - a String to convert converted Double
throws:
NumberFormatException - if the value cannot be converted |
| createFloat | | public static Float createFloat(String val)(Code) | | Convert a String to a Float.
Parameters:
val - a String to convert converted Float
throws:
NumberFormatException - if the value cannot be converted |
| createInteger | | public static Integer createInteger(String val)(Code) | | Convert a String to a Integer, handling
hex and octal notations.
Parameters:
val - a String to convert converted Integer
throws:
NumberFormatException - if the value cannot be converted |
| createLong | | public static Long createLong(String val)(Code) | | Convert a String to a Long.
Parameters:
val - a String to convert converted Long
throws:
NumberFormatException - if the value cannot be converted |
| createNumber | | public static Number createNumber(String val) throws NumberFormatException(Code) | | Turns a string value into a java.lang.Number.
First, the value is examined for a type qualifier on the end
('f','F','d','D','l','L'). If it is found, it starts
trying to create successively larger types from the type specified
until one is found that can hold the value.
If a type specifier is not found, it will check for a decimal point
and then try successively larger types from Integer to
BigInteger and from Float to
BigDecimal.
If the string starts with 0x or -0x, it
will be interpreted as a hexadecimal integer. Values with leading
0's will not be interpreted as octal.
Parameters:
val - String containing a number Number created from the string
throws:
NumberFormatException - if the value cannot be converted |
| isDigits | | public static boolean isDigits(String str)(Code) | | Checks whether the String contains only
digit characters.
Null and empty String will return
false.
Parameters:
str - the String to check true if str contains only unicode numeric |
| isNumber | | public static boolean isNumber(String str)(Code) | | Checks whether the String a valid Java number.
Valid numbers include hexadecimal marked with the 0x
qualifier, scientific notation and numbers marked with a type
qualifier (e.g. 123L).
Null and empty String will return
false.
Parameters:
str - the String to check true if the string is a correctly formatted number |
| maximum | | public static long maximum(long a, long b, long c)(Code) | | Gets the maximum of three long values.
Parameters:
a - value 1
Parameters:
b - value 2
Parameters:
c - value 3 the largest of the values |
| maximum | | public static int maximum(int a, int b, int c)(Code) | | Gets the maximum of three int values.
Parameters:
a - value 1
Parameters:
b - value 2
Parameters:
c - value 3 the largest of the values |
| minimum | | public static long minimum(long a, long b, long c)(Code) | | Gets the minimum of three long values.
Parameters:
a - value 1
Parameters:
b - value 2
Parameters:
c - value 3 the smallest of the values |
| minimum | | public static int minimum(int a, int b, int c)(Code) | | Gets the minimum of three int values.
Parameters:
a - value 1
Parameters:
b - value 2
Parameters:
c - value 3 the smallest of the values |
| stringToInt | | public static int stringToInt(String str)(Code) | | Convert a String to an int, returning
zero if the conversion fails.
Parameters:
str - the string to convert the int represented by the string, or zero ifconversion fails |
| stringToInt | | public static int stringToInt(String str, int defaultValue)(Code) | | Convert a String to an int, returning a
default value if the conversion fails.
Parameters:
str - the string to convert
Parameters:
defaultValue - the default value the int represented by the string, or the default if conversion fails |
|
|