com.jn.langx.util

类 Numbers

java.lang.Object

com.jn.langx.util.Numbers

public class Numbers
extends Object

构造器概要

构造器

构造器和说明
Numbers()

方法概要

限定符和类型	方法和说明
static Number	add(Number left, Number right)
static <T extends Number> T	convertNumberToTargetClass(Number number, Class<T> targetClass) Convert the given number into an instance of the given target class.
static BigDecimal	createBigDecimal(String str) Convert a String to a BigDecimal.
static BigInteger	createBigInteger(String str) Convert a String to a BigInteger.
static Double	createDouble(String str) Convert a String to a Double.
static Float	createFloat(String str) Convert a String to a Float.
static Integer	createInteger(String str)
static Long	createLong(String str) Convert a String to a Long.
static Number	createNumber(String str)
static Number	div(Number left, Number right)
static boolean	isDigits(String str) Checks whether the String contains only digit characters.
static boolean	isDouble(Number number)
static boolean	isInteger(Number number)
static boolean	isLong(Number number)
static boolean	isNumber(String str) Checks whether the String a valid Java number.
static Number	mod(Number left, Number right)
static Number	mul(Number left, Number right)
static <T extends Number> T	parseNumber(String text, Class<T> targetClass) Parse the given text into a Number instance of the given target class, using the corresponding decode / valueOf method.
static <T extends Number> T	parseNumber(String text, Class<T> targetClass, NumberFormat numberFormat) Parse the given text into a Number instance of the given target class, using the supplied NumberFormat.
static Number	sub(Number left, Number right)
static byte	toByte(Number number)
static double	toDouble(Number number)
static float	toFloat(Number number)
static int	toInt(Number number)
static long	toLong(Number number)
static short	toShort(Number number)

从类继承的方法 java.lang.Object

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

构造器详细资料

Numbers

public Numbers()

方法详细资料

createFloat

public static Float createFloat(String str)

Convert a String to a Float.

Returns null if the string is null.

参数:

str - a String to convert, may be null

返回:

converted Float

抛出:

NumberFormatException - if the value cannot be converted

createDouble

public static Double createDouble(String str)

Convert a String to a Double.

Returns null if the string is null.

参数:

str - a String to convert, may be null

返回:

converted Double

抛出:

NumberFormatException - if the value cannot be converted

createInteger

public static Integer createInteger(String str)

createLong

public static Long createLong(String str)

Convert a String to a Long.

Returns null if the string is null.

参数:

str - a String to convert, may be null

返回:

converted Long

抛出:

NumberFormatException - if the value cannot be converted

createBigInteger

public static BigInteger createBigInteger(String str)

Convert a String to a BigInteger.

Returns null if the string is null.

参数:

str - a String to convert, may be null

返回:

converted BigInteger

抛出:

NumberFormatException - if the value cannot be converted

createBigDecimal

public static BigDecimal createBigDecimal(String str)

Convert a String to a BigDecimal.

Returns null if the string is null.

参数:

str - a String to convert, may be null

返回:

converted BigDecimal

抛出:

NumberFormatException - if the value cannot be converted

isDigits

public 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 numeric

isNumber

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. 123L).

Null and empty String will return false.

参数:

str - the String to check

返回:

true if the string is a correctly formatted number

createNumber

public static Number createNumber(String str)
                           throws NumberFormatException

抛出:

NumberFormatException

parseNumber

public static <T extends Number> T parseNumber(String text,
                                               Class<T> targetClass)

Parse the given text into a Number instance of the given target class, using the corresponding decode / valueOf method.

Trims all whitespace (leading, trailing, and in between characters) from the input String before attempting to parse the number.

Supports numbers in hex format (with leading "0x", "0X", or "#") as well.

参数:

text - the text to convert

targetClass - the target class to parse into

返回:

the parsed number

抛出:

IllegalArgumentException - if the target class is not supported (i.e. not a standard Number subclass as included in the JDK)

另请参阅:

Byte.decode(java.lang.String), Short.decode(java.lang.String), Integer.decode(java.lang.String), Long.decode(java.lang.String), decodeBigInteger(String), Float.valueOf(java.lang.String), Double.valueOf(java.lang.String), BigDecimal.BigDecimal(String)

parseNumber

public static <T extends Number> T parseNumber(String text,
                                               Class<T> targetClass,
                                               @Nullable
                                               NumberFormat numberFormat)

Parse the given text into a Number instance of the given target class, using the supplied NumberFormat.

Trims the input String before attempting to parse the number.

参数:

text - the text to convert

targetClass - the target class to parse into

numberFormat - the NumberFormat to use for parsing (if null, this method falls back to parseNumber(String, Class))

返回:

the parsed number

抛出:

IllegalArgumentException - if the target class is not supported (i.e. not a standard Number subclass as included in the JDK)

另请参阅:

NumberFormat.parse(java.lang.String, java.text.ParsePosition), convertNumberToTargetClass(java.lang.Number, java.lang.Class<T>), parseNumber(String, Class)

convertNumberToTargetClass

public static <T extends Number> T convertNumberToTargetClass(Number number,
                                                              Class<T> targetClass)
                                                       throws IllegalArgumentException

Convert the given number into an instance of the given target class.

参数:

number - the number to convert

targetClass - the target class to convert to

返回:

the converted number

抛出:

IllegalArgumentException - if the target class is not supported (i.e. not a standard Number subclass as included in the JDK)

另请参阅:

Byte, Short, Integer, Long, BigInteger, Float, Double, BigDecimal

toInt

public static int toInt(Number number)

toLong

public static long toLong(Number number)

toDouble

public static double toDouble(Number number)

toFloat

public static float toFloat(Number number)

toShort

public static short toShort(Number number)

toByte

public static byte toByte(Number number)

mod

public static Number mod(Number left,
                         Number right)

add

public static Number add(Number left,
                         Number right)

sub

public static Number sub(Number left,
                         Number right)

mul

public static Number mul(Number left,
                         Number right)

div

public static Number div(Number left,
                         Number right)

isInteger

public static boolean isInteger(Number number)

isDouble

public static boolean isDouble(Number number)

isLong

public static boolean isLong(Number number)