Package org.drasyl.util

Class NumberUtil

java.lang.Object

org.drasyl.util.NumberUtil

public final class NumberUtil
extends Object

Utility class for number-related operations.

Method Summary

Modifier and Type	Method	Description
static String	numberToHumanData(Number number)	Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.
static String	numberToHumanData(Number number, short precision)	Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.
static String	numberToHumanData(Number number, short precision, Locale locale)	Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.
static String	numberToHumanData(Number number, Locale locale)	Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.
static String	numberToHumanDataRate(Number number)	Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.
static String	numberToHumanDataRate(Number number, short precision)	Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.
static String	numberToHumanDataRate(Number number, short precision, Locale locale)	Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.
static String	numberToHumanDataRate(Number number, Locale locale)	Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.

Methods inherited from class java.lang.Object

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

Method Detail

numberToHumanData

public static String numberToHumanData(Number number,
                                       short precision,
                                       Locale locale)

Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.

Inspired by https://stackoverflow.com/a/3758880/1074188.

Parameters:

number - number containing size in bytes

precision - Sets the precision of the number. Value -1 has a special meaning here: an absolute formatted number less then 10 results in precision 2; an absolute formatted number less then 100 results in precision 1; all other absolute formatted numbers result in precision 0

locale - The locale to apply during formatting. If locale is null then no localization is applied.

Returns:

the formatted SI (metric) multiple-byte number

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanData

public static String numberToHumanData(Number number,
                                       short precision)

Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.

Parameters:

number - number containing size in bytes

precision - Sets the precision of the number. Value -1 has a special meaning here: an absolute formatted number less then 10 results in precision 2; an absolute formatted number less then 100 results in precision 1; all other absolute formatted numbers result in precision 0

Returns:

the formatted SI (metric) multiple-byte number

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanData

public static String numberToHumanData(Number number,
                                       Locale locale)

Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.

Parameters:

number - number containing size in bytes

locale - The locale to apply during formatting. If locale is null then no localization is applied.

Returns:

the formatted SI (metric) multiple-byte number

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanData

public static String numberToHumanData(Number number)

Takes a Number with bytes and returns it as a formatted SI (metric) multiple-byte number.

Parameters:

number - number containing size in bytes

Returns:

the formatted SI (metric) multiple-byte number

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanDataRate

public static String numberToHumanDataRate(Number number,
                                           short precision,
                                           Locale locale)

Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.

Inspired by https://stackoverflow.com/a/3758880/1074188.

Parameters:

number - number containing size in bytes

precision - Sets the precision of the number. Value -1 has a special meaning here: an absolute formatted number less then 10 results in precision 2; an absolute formatted number less then 100 results in precision 1; all other absolute formatted numbers result in precision 0

locale - The locale to apply during formatting. If locale is null then no localization is applied.

Returns:

the formatted SI (metric) data-rate

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanDataRate

public static String numberToHumanDataRate(Number number,
                                           short precision)

Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.

Parameters:

number - number containing size in bytes

precision - Sets the precision of the number. Value -1 has a special meaning here: an absolute formatted number less then 10 results in precision 2; an absolute formatted number less then 100 results in precision 1; all other absolute formatted numbers result in precision 0

Returns:

the formatted SI (metric) data-rate

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanDataRate

public static String numberToHumanDataRate(Number number,
                                           Locale locale)

Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.

Parameters:

number - number containing size in bytes

locale - The locale to apply during formatting. If locale is null then no localization is applied.

Returns:

the formatted SI (metric) data-rate

Throws:

IllegalArgumentException - if precision is less than -1

numberToHumanDataRate

public static String numberToHumanDataRate(Number number)

Takes a Number with bytes and returns it as a formatted SI (metric) data-rate.

Parameters:

number - number containing size in bytes

Returns:

the formatted SI (metric) data-rate

Throws:

IllegalArgumentException - if precision is less than -1