net.razorvine.pickle

Class PickleUtils

java.lang.Object

net.razorvine.pickle.PickleUtils

public abstract class PickleUtils
extends Object

Utility stuff for dealing with pickle data streams.

Author:

Irmen de Jong (irmen@razorvine.net)

Constructor Summary

Constructors

Constructor and Description
PickleUtils()

Method Summary

Modifier and Type	Method and Description
static double	bytes_to_double(byte[] bytes, int offset) Convert a big endian 8-byte to a double.
static float	bytes_to_float(byte[] bytes, int offset) Convert a big endian 4-byte to a float.
static int	bytes_to_integer(byte[] bytes) Convert a couple of bytes into the corresponding integer number.
static int	bytes_to_integer(byte[] bytes, int offset, int size)
static long	bytes_to_long(byte[] bytes, int offset) Convert 8 little endian bytes into a long
static long	bytes_to_uint(byte[] bytes, int offset) Convert 4 little endian bytes into an unsigned int (as a long)
static String	decode_escaped(String str) Decode a string with possible escaped char sequences in it (\x??).
static Number	decode_long(byte[] data) read an arbitrary 'long' number.
static String	decode_unicode_escaped(String str) Decode a string with possible escaped unicode in it (€)
static byte[]	double_to_bytes(double d) Convert a double to its 8-byte representation (big endian).
static byte[]	encode_long(BigInteger big) encode an arbitrary long number into a byte array (little endian).
static byte[]	integer_to_bytes(int i) Convert a signed integer to its 4-byte representation.
static Number	optimizeBigint(BigInteger bigint) Optimize a biginteger, if possible return a long primitive datatype.
static String	rawStringFromBytes(byte[] data) Construct a String from the given bytes where these are directly converted to the corresponding chars, without using a given character encoding
static short	readbyte(InputStream input) read a single unsigned byte
static void	readbytes_into(InputStream input, byte[] buffer, int offset, int length) read a number of signed bytes into the specified location in an existing byte array
static byte[]	readbytes(InputStream input, int n) read a number of signed bytes
static byte[]	readbytes(InputStream input, long n) read a number of signed bytes
static String	readline(InputStream input) read a line of text, excluding the terminating LF char
static String	readline(InputStream input, boolean includeLF) read a line of text, possibly including the terminating LF char
static byte[]	str2bytes(String str) Convert a string to a byte array, no encoding is used.

Methods inherited from class java.lang.Object

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

Constructor Detail

PickleUtils

public PickleUtils()

Method Detail

readline

public static String readline(InputStream input)
                       throws IOException

read a line of text, excluding the terminating LF char

Throws:

IOException

readline

public static String readline(InputStream input,
                              boolean includeLF)
                       throws IOException

read a line of text, possibly including the terminating LF char

Throws:

IOException

readbyte

public static short readbyte(InputStream input)
                      throws IOException

read a single unsigned byte

Throws:

IOException

readbytes

public static byte[] readbytes(InputStream input,
                               int n)
                        throws IOException

read a number of signed bytes

Throws:

IOException

readbytes

public static byte[] readbytes(InputStream input,
                               long n)
                        throws IOException

read a number of signed bytes

Throws:

IOException

readbytes_into

public static void readbytes_into(InputStream input,
                                  byte[] buffer,
                                  int offset,
                                  int length)
                           throws IOException

read a number of signed bytes into the specified location in an existing byte array

Throws:

IOException

bytes_to_integer

public static int bytes_to_integer(byte[] bytes)

Convert a couple of bytes into the corresponding integer number. Can deal with 2-bytes unsigned int and 4-bytes signed int.

bytes_to_integer

public static int bytes_to_integer(byte[] bytes,
                                   int offset,
                                   int size)

bytes_to_long

public static long bytes_to_long(byte[] bytes,
                                 int offset)

Convert 8 little endian bytes into a long

bytes_to_uint

public static long bytes_to_uint(byte[] bytes,
                                 int offset)

Convert 4 little endian bytes into an unsigned int (as a long)

integer_to_bytes

public static byte[] integer_to_bytes(int i)

Convert a signed integer to its 4-byte representation. (little endian)

double_to_bytes

public static byte[] double_to_bytes(double d)

Convert a double to its 8-byte representation (big endian).

bytes_to_double

public static double bytes_to_double(byte[] bytes,
                                     int offset)

Convert a big endian 8-byte to a double.

bytes_to_float

public static float bytes_to_float(byte[] bytes,
                                   int offset)

Convert a big endian 4-byte to a float.

decode_long

public static Number decode_long(byte[] data)

read an arbitrary 'long' number. Returns an int/long/BigInteger as appropriate to hold the number.

encode_long

public static byte[] encode_long(BigInteger big)

encode an arbitrary long number into a byte array (little endian).

optimizeBigint

public static Number optimizeBigint(BigInteger bigint)

Optimize a biginteger, if possible return a long primitive datatype.

rawStringFromBytes

public static String rawStringFromBytes(byte[] data)

Construct a String from the given bytes where these are directly converted to the corresponding chars, without using a given character encoding

str2bytes

public static byte[] str2bytes(String str)
                        throws IOException

Convert a string to a byte array, no encoding is used. String must only contain characters <256.

Throws:

IOException

decode_escaped

public static String decode_escaped(String str)

Decode a string with possible escaped char sequences in it (\x??).

decode_unicode_escaped

public static String decode_unicode_escaped(String str)

Decode a string with possible escaped unicode in it (€)