net.rim.device.api.util
Class NumberUtilities

java.lang.Object
  |
  +--net.rim.device.api.util.NumberUtilities

public final class NumberUtilities

extends Object

Utility methods for converting numeric values to their character/string digit equivalents.

Method Summary

static void	appendNumber(StringBuffer strBuf, byte num, int radix) Appends digits for byte value to buffer.
static void	appendNumber(StringBuffer strBuf, byte num, int radix, int minWidth) Appends digits with padding for byte value to buffer.
static void	appendNumber(StringBuffer strBuf, int num) Appends digits for decimal integer value to buffer.
static void	appendNumber(StringBuffer strBuf, int num, int radix) Appends digits for integer value to buffer.
static void	appendNumber(StringBuffer strBuf, int num, int radix, int minWidth) Appends digits with padding for integer value to buffer.
static void	appendNumber(StringBuffer strBuf, long num) Appends digits for decimal long integer value to buffer.
static void	appendNumber(StringBuffer strBuf, long num, int radix) Appends digits for long integer value to buffer.
static void	appendNumber(StringBuffer strBuf, long num, int radix, int minWidth) Appends digits with padding for long integer value to buffer.
static void	appendNumber(StringBuffer strBuf, short num, int radix) Appends digits for short integer value to buffer.
static void	appendNumber(StringBuffer strBuf, short num, int radix, int minWidth) Appends digits with padding for short integer value to buffer.
static int	hexDigitToInt(char dig) Converts hex digit to integer value.
static int	hexDigitToInt(char dig, int err_val) Converts hex digit to integer value, using provided error value.
static char	intToHexDigit(int value) Converts integer value to hex digit.
static char	intToUpperHexDigit(int value) Converts integer value to upper case hex digit.
static String	toString(byte num, int radix) Retrieves digits for byte value.
static String	toString(byte num, int radix, int minWidth) Retrieves digits with padding for byte value.
static String	toString(int num, int radix) Retrieves digits for integer value.
static String	toString(int num, int radix, int minWidth) Retrieves digits with padding for integer value.
static String	toString(long num, int radix) Retrieves digits for long integer value.
static String	toString(long num, int radix, int minWidth) Retrieves digits with padding for long integer value.
static String	toString(short num, int radix) Retrieves digits for short integer value.
static String	toString(short num, int radix, int minWidth) Retrieves digits with padding for short integer value.

Methods inherited from class java.lang.Object

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

Method Detail

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      byte num,
                                      int radix)

Appends digits for byte value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      byte num,
                                      int radix,
                                      int minWidth)

Appends digits with padding for byte value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Since:

JDE 3.7.0

toString

public static final String toString(byte num,
                                    int radix)

Retrieves digits for byte value.

Parameters:

num - Value to convert.

radix - Radix for value.

Returns:

String containing digits for byte value.

Since:

JDE 3.7.0

toString

public static final String toString(byte num,
                                    int radix,
                                    int minWidth)

Retrieves digits with padding for byte value.

Parameters:

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Returns:

String containing digits for byte value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      short num,
                                      int radix)

Appends digits for short integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      short num,
                                      int radix,
                                      int minWidth)

Appends digits with padding for short integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Since:

JDE 3.7.0

toString

public static final String toString(short num,
                                    int radix)

Retrieves digits for short integer value.

Parameters:

num - Value to convert.

radix - Radix for value.

Returns:

String containing digits for short integer value.

Since:

JDE 3.7.0

toString

public static final String toString(short num,
                                    int radix,
                                    int minWidth)

Retrieves digits with padding for short integer value.

Parameters:

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Returns:

String containing digits for short integer value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      int num)

Appends digits for decimal integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      int num,
                                      int radix)

Appends digits for integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      int num,
                                      int radix,
                                      int minWidth)

Appends digits with padding for integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Since:

JDE 3.7.0

toString

public static final String toString(int num,
                                    int radix)

Retrieves digits for integer value.

Parameters:

num - Value to convert.

radix - Radix for value.

Returns:

String containing digits for integer value.

Since:

JDE 3.7.0

toString

public static final String toString(int num,
                                    int radix,
                                    int minWidth)

Retrieves digits with padding for integer value.

Parameters:

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Returns:

String containing digits for integer value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      long num)

Appends digits for decimal long integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      long num,
                                      int radix)

Appends digits for long integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

Since:

JDE 3.7.0

appendNumber

public static final void appendNumber(StringBuffer strBuf,
                                      long num,
                                      int radix,
                                      int minWidth)

Appends digits with padding for long integer value to buffer.

Parameters:

strBuf - Buffer to contain result.

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Since:

JDE 3.7.0

toString

public static final String toString(long num,
                                    int radix)

Retrieves digits for long integer value.

Parameters:

num - Value to convert.

radix - Radix for value.

Returns:

String containing digits for long integer value.

Since:

JDE 3.7.0

toString

public static final String toString(long num,
                                    int radix,
                                    int minWidth)

Retrieves digits with padding for long integer value.

Parameters:

num - Value to convert.

radix - Radix for value.

minWidth - Pads digits with leading zeroes to meet this width.

Returns:

String containing digits for long integer value.

Since:

JDE 3.7.0

intToHexDigit

public static char intToHexDigit(int value)

Converts integer value to hex digit.

Parameters:

value - Lowest 4 bits of this value used to create the hex digit.

Returns:

Hex digit for lowest 4 bits of provided value.

Since:

JDE 3.7.0

intToUpperHexDigit

public static char intToUpperHexDigit(int value)

Converts integer value to upper case hex digit.

Parameters:

value - Lowest 4 bits of this value used to create the upper-case hex digit.

Returns:

Upper-case hex digit for lowest 4 bits of provided value.

Since:

JDE 3.7.0

hexDigitToInt

public static int hexDigitToInt(char dig)
                         throws NumberFormatException

Converts hex digit to integer value.

Parameters:

dig - Single hex digit (can be lower or upper-case).

Returns:

Integer value for hex digit (value between 0 and 15).

Throws:

NumberFormatException - If provided digit isn't valid hex digit.

Since:

JDE 3.7.0

hexDigitToInt

public static int hexDigitToInt(char dig,
                                int err_val)

Converts hex digit to integer value, using provided error value.

Parameters:

dig - Single hex digit (can be lower or upper-case).

err_val - Error value to return if provided digit isn't a valid hex digit.

Returns:

Integer value for hex digit (value between 0 and 15).

Since:

JDE 3.7.0