|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.commons.lang.NumberUtils
public final class NumberUtils
Provides extra functionality for Java Number classes.
Constructor Summary | |
---|---|
NumberUtils()
Deprecated. NumberUtils instances should NOT be constructed in standard programming. |
Method Summary | |
---|---|
static int |
compare(double lhs,
double rhs)
Deprecated. Compares two doubles for order. |
static int |
compare(float lhs,
float rhs)
Deprecated. Compares two floats for order. |
static BigDecimal |
createBigDecimal(String val)
Deprecated. Convert a String to a BigDecimal . |
static BigInteger |
createBigInteger(String val)
Deprecated. Convert a String to a BigInteger . |
static Double |
createDouble(String val)
Deprecated. Convert a String to a Double . |
static Float |
createFloat(String val)
Deprecated. Convert a String to a Float . |
static Integer |
createInteger(String val)
Deprecated. Convert a String to a Integer , handling
hex and octal notations. |
static Long |
createLong(String val)
Deprecated. Convert a String to a Long . |
static Number |
createNumber(String val)
Deprecated. Turns a string value into a java.lang.Number. |
static boolean |
isDigits(String str)
Deprecated. Checks whether the String contains only
digit characters. |
static boolean |
isNumber(String str)
Deprecated. Checks whether the String a valid Java number. |
static int |
maximum(int a,
int b,
int c)
Deprecated. Gets the maximum of three int values. |
static long |
maximum(long a,
long b,
long c)
Deprecated. Gets the maximum of three long values. |
static int |
minimum(int a,
int b,
int c)
Deprecated. Gets the minimum of three int values. |
static long |
minimum(long a,
long b,
long c)
Deprecated. Gets the minimum of three long values. |
static int |
stringToInt(String str)
Deprecated. Convert a String to an int , returning
zero if the conversion fails. |
static int |
stringToInt(String str,
int defaultValue)
Deprecated. Convert a String to an int , returning a
default value if the conversion fails. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public NumberUtils()
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.
Method Detail |
---|
public static int stringToInt(String str)
Convert a String
to an int
, returning
zero
if the conversion fails.
str
- the string to convert
zero
if
conversion failspublic static int stringToInt(String str, int defaultValue)
Convert a String
to an int
, returning a
default value if the conversion fails.
str
- the string to convertdefaultValue
- the default value
public static Number createNumber(String val) throws NumberFormatException
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.
val
- String containing a number
NumberFormatException
- if the value cannot be convertedpublic static Float createFloat(String val)
Convert a String
to a Float
.
val
- a String
to convert
Float
NumberFormatException
- if the value cannot be convertedpublic static Double createDouble(String val)
Convert a String
to a Double
.
val
- a String
to convert
Double
NumberFormatException
- if the value cannot be convertedpublic static Integer createInteger(String val)
Convert a String
to a Integer
, handling
hex and octal notations.
val
- a String
to convert
Integer
NumberFormatException
- if the value cannot be convertedpublic static Long createLong(String val)
Convert a String
to a Long
.
val
- a String
to convert
Long
NumberFormatException
- if the value cannot be convertedpublic static BigInteger createBigInteger(String val)
Convert a String
to a BigInteger
.
val
- a String
to convert
BigInteger
NumberFormatException
- if the value cannot be convertedpublic static BigDecimal createBigDecimal(String val)
Convert a String
to a BigDecimal
.
val
- a String
to convert
BigDecimal
NumberFormatException
- if the value cannot be convertedpublic static long minimum(long a, long b, long c)
Gets the minimum of three long
values.
a
- value 1b
- value 2c
- value 3
public static int minimum(int a, int b, int c)
Gets the minimum of three int
values.
a
- value 1b
- value 2c
- value 3
public static long maximum(long a, long b, long c)
Gets the maximum of three long
values.
a
- value 1b
- value 2c
- value 3
public static int maximum(int a, int b, int c)
Gets the maximum of three int
values.
a
- value 1b
- value 2c
- value 3
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.
-1
if the first value is less than the second.
+1
if the first value is greater than the second.
0
if the values are equal.
The ordering is as follows, largest to smallest:
Comparing NaN
with NaN
will
return 0
.
lhs
- the first double
rhs
- the second double
-1
if lhs is less, +1
if greater,
0
if equal to rhspublic 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.
-1
if the first value is less than the second.
+1
if the first value is greater than the second.
0
if the values are equal.
The ordering is as follows, largest to smallest:
Comparing NaN
with NaN
will return
0
.
lhs
- the first float
rhs
- the second float
-1
if lhs is less, +1
if greater,
0
if equal to rhspublic static boolean isDigits(String str)
Checks whether the String
contains only
digit characters.
Null
and empty String will return
false
.
str
- the String
to check
true
if str contains only unicode numericpublic 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. 123L).
Null
and empty String will return
false
.
str
- the String
to check
true
if the string is a correctly formatted number
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |