biz.onixs.util

Class Converter

java.lang.Object

biz.onixs.util.Converter

public class Converter
extends Object

Utility class to convert numbers between string representation and numeric.

Method Summary

Modifier and Type	Method and Description
static int	double2str(byte[] buffer, double value, int precision) Converts double to string and places it into a byte buffer.
static int	double2str(byte[] buffer, int offset, double value, int precision) Converts double to string and places it into a byte buffer.
static String	double2str(double value) Converts double value to string.
static String	double2str(double value, int precision) Converts double value to string.
static int	i2str(byte[] buffer, int value) Converts integer to string and places it into a byte buffer.
static int	i2str(byte[] buffer, int offset, int value) Converts integer to string and places it into a byte buffer.
static String	i2str(int value) Converts integer to string.
static int	long2str(byte[] buffer, int offset, long value) Converts long to string and places it into a byte buffer.
static int	long2str(byte[] buffer, long value) Converts long to string and places it into a byte buffer.
static void	long2str(DynamicByteBuffer buffer, long value) Converts long to string and places it into a ByteBuffer.
static double	str2double(byte[] buffer, int offset, int length, boolean strict) Converts string in the byte buffer to double.
static double	str2double(String s, boolean strict) Converts string to double.
static int	str2int(byte[] buffer, int offset, int length, boolean strict) Converts string in the byte buffer to int.
static int	str2int(String s, boolean strict) Converts string to int.
static long	str2long(byte[] buffer, int offset, int length, boolean strict) Converts string in the byte buffer to long.
static long	str2long(String s, boolean strict) Converts string to long.

Methods inherited from class java.lang.Object

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

Method Detail

double2str

public static String double2str(double value)

Converts double value to string.

Parameters:

value - double value to convert

Returns:

converted string representation

double2str

public static String double2str(double value,
                                int precision)

Converts double value to string.

Parameters:

value - double value to convert

precision - precision of the double in the string

Returns:

converted string representation

double2str

public static int double2str(byte[] buffer,
                             double value,
                             int precision)

Converts double to string and places it into a byte buffer.

Parameters:

buffer - target buffer

value - value to convert

precision - precision of the double in the string

Returns:

converted value bytes length

Throws:

NullPointerException - if buffer == null

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

double2str

public static int double2str(byte[] buffer,
                             int offset,
                             double value,
                             int precision)

Converts double to string and places it into a byte buffer.

Parameters:

buffer - target buffer

offset - buffer offset

value - value to convert

precision - precision of the double in the string

Returns:

converted value bytes length

Throws:

NullPointerException - if buffer == null

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

IllegalArgumentException - if (precision < 0) || (precision > 10)

str2double

public static double str2double(byte[] buffer,
                                int offset,
                                int length,
                                boolean strict)

Converts string in the byte buffer to double.

Please note that byte buffer should not contain exponent (e.g. 'e' or 'E' symbol).

Parameters:

buffer - source buffer

offset - value offset

length - value length

strict - whether to throw exception if not all bytes can be converted

Returns:

converted value

Throws:

NullPointerException - if (buffer == null)

IllegalArgumentException - if ((offset < 0) || (offset + length > buffer.length)) or (length <= 0) or (valueLimit <= 0)

NumberFormatException - if strict is true and not all bytes can be converted

str2double

public static double str2double(String s,
                                boolean strict)

Converts string to double.

Parameters:

s - string to be converted

strict - whether to throw exception if not all chars can be converted

Returns:

converted value

Throws:

NullPointerException - if (s == null)

NumberFormatException - if strict is true and not all chars can be converted

i2str

public static int i2str(byte[] buffer,
                        int offset,
                        int value)

Converts integer to string and places it into a byte buffer.

Parameters:

buffer - target buffer

offset - buffer offset

value - value to convert

Returns:

converted value bytes length

Throws:

NullPointerException - if buffer == null

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

i2str

public static String i2str(int value)

Converts integer to string.

Parameters:

value - value to convert

Returns:

converted value bytes length

Throws:

NullPointerException - if buffer == null

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

long2str

public static int long2str(byte[] buffer,
                           long value)

Converts long to string and places it into a byte buffer.

Parameters:

buffer - target buffer

value - value to convert

Returns:

converted value bytes length

Throws:

NullPointerException - if buffer == null

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

long2str

public static int long2str(byte[] buffer,
                           int offset,
                           long value)

Converts long to string and places it into a byte buffer.

Parameters:

buffer - target buffer

offset - buffer offset

value - value to convert

Returns:

converted value bytes length

Throws:

NullPointerException - if null == buffer

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

long2str

public static void long2str(DynamicByteBuffer buffer,
                            long value)

Converts long to string and places it into a ByteBuffer.

Parameters:

buffer - target buffer

value - value to convert

Throws:

NullPointerException - if null == buffer

i2str

public static int i2str(byte[] buffer,
                        int value)

Converts integer to string and places it into a byte buffer.

Parameters:

buffer - target buffer

value - value to convert

Returns:

converted value bytes length

Throws:

NullPointerException - if buffer == null

IllegalArgumentException - if (offset < 0) || (offset >= buffer.length)

str2int

public static int str2int(byte[] buffer,
                          int offset,
                          int length,
                          boolean strict)

Converts string in the byte buffer to int.

Parameters:

buffer - source buffer

offset - value offset

length - value length

strict - whether to throw exception if not all bytes can be converted

Returns:

converted value

Throws:

NullPointerException - if (buffer == null)

IllegalArgumentException - if ((offset < 0) || (offset + length > buffer.length)) or (length <= 0)

NumberFormatException - if strict is true and not all bytes can be converted

str2int

public static int str2int(String s,
                          boolean strict)

Converts string to int.

Parameters:

s - string to be converted

strict - whether to throw exception if not all chars can be converted

Returns:

converted value

Throws:

NullPointerException - if (s == null)

NumberFormatException - if strict is true and not all chars can be converted

str2long

public static long str2long(byte[] buffer,
                            int offset,
                            int length,
                            boolean strict)

Converts string in the byte buffer to long.

Parameters:

buffer - source buffer

offset - value offset

length - value length

strict - whether to throw exception if not all bytes can be converted

Returns:

converted value

Throws:

NullPointerException - if (buffer == null)

IllegalArgumentException - if ((offset < 0) || (offset + length > buffer.length)) or (length <= 0)

NumberFormatException - if strict is true and not all bytes can be converted

str2long

public static long str2long(String s,
                            boolean strict)

Converts string to long.

Parameters:

s - string to be converted

strict - whether to throw exception if not all chars can be converted

Returns:

converted value

Throws:

NullPointerException - if (s == null)

NumberFormatException - if strict is true and not all chars can be converted