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 double	max(double... numbers)	Returns the largest given number.
static int	max(int... numbers)	Returns the largest given number.
static long	max(long... numbers)	Returns the largest given number.
static double	min(double... numbers)	Returns the smallest given number.
static int	min(int... numbers)	Returns the smallest given number.
static long	min(long... numbers)	Returns the smallest given number.
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.
static double	sampleStandardDeviation(double... values)	Returns the corrected sample standard deviation of given values.
static double	sampleVariance(double... values)	Returns the unbiased sample variance of given values.

Methods inherited from class java.lang.Object

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

Method Details

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

sampleVariance

public static double sampleVariance(double... values)

Returns the unbiased sample variance of given values.

sampleStandardDeviation

public static double sampleStandardDeviation(double... values)

Returns the corrected sample standard deviation of given values.

min

public static int min(int... numbers)

Returns the smallest given number.

Returns:

the smallest number in numbers.

Throws:

NoSuchElementException - if no numbers were given

min

public static long min(long... numbers)

Returns the smallest given number.

Returns:

the smallest number in numbers.

Throws:

NoSuchElementException - if no numbers were given

min

public static double min(double... numbers)

Returns the smallest given number.

Returns:

the smallest number in numbers.

Throws:

NoSuchElementException - if no numbers were given

max

public static int max(int... numbers)

Returns the largest given number.

Returns:

the largest number in numbers.

Throws:

NoSuchElementException - if no numbers were given

max

public static long max(long... numbers)

Returns the largest given number.

Returns:

the largest number in numbers.

Throws:

NoSuchElementException - if no numbers were given

max

public static double max(double... numbers)

Returns the largest given number.

Returns:

the largest number in numbers.

Throws:

NoSuchElementException - if no numbers were given