com.io7m.jintegers

Class Signed64

java.lang.Object

com.io7m.jintegers.Signed64

public final class Signed64
extends Object

64-bit integer packing/unpacking functions.

Method Summary

Methods

Modifier and Type	Method and Description
static ByteBuffer	packToBuffer(long i, ByteBuffer r, int index) Pack i into a byte buffer r using the encoding returned by ByteBuffer.order(), starting at index.
static ByteBuffer	packToBufferBigEndian(long i, ByteBuffer r, int index) Pack i into a byte buffer r using a big-endian encoding such that the most significant byte is in r[index].
static ByteBuffer	packToBufferLittleEndian(long i, ByteBuffer r, int index) Pack i into a byte buffer r using a little-endian encoding such that the least significant byte is in r[index].
static byte[]	packToBytesBigEndian(long i, byte[] r) Pack i into a byte buffer r using a big-endian encoding such that the most significant byte is in r[0].
static byte[]	packToBytesBigEndianAllocate(long i) Pack i into a byte buffer b using a big-endian encoding such that the most significant byte is in b[0].
static byte[]	packToBytesLittleEndian(long i, byte[] r) Pack i into a byte buffer r using a little-endian encoding such that the least significant byte is in r[0].
static byte[]	packToBytesLittleEndianAllocate(long i) Pack i into a byte buffer b using a little-endian encoding such that the least significant byte is in b[0].
static long	unpackFromBuffer(ByteBuffer buffer, int index) Unpack an integer from buffer using the encoding returned by ByteBuffer.order(), starting at index.
static long	unpackFromBufferBigEndian(ByteBuffer buffer, int index) Unpack an integer from buffer assuming a big-endian encoding such that the most significant byte is in b[index].
static long	unpackFromBufferLittleEndian(ByteBuffer buffer, int index) Unpack an integer from buffer assuming a little-endian encoding such that the least significant byte is in b[index] .
static long	unpackFromBytesBigEndian(byte[] buffer) Unpack an integer from buffer assuming a big-endian encoding such that the most significant byte is in b[0].
static long	unpackFromBytesLittleEndian(byte[] buffer) Unpack an integer from buffer assuming a little-endian encoding such that the least significant byte is in b[0].

Methods inherited from class java.lang.Object

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

Method Detail

packToBytesBigEndianAllocate

public static byte[] packToBytesBigEndianAllocate(long i)

Pack i into a byte buffer b using a big-endian encoding such that the most significant byte is in b[0].

Parameters:

i - The value to be packed.

Returns:

A byte buffer containing the packed integer data.

packToBytesBigEndian

public static byte[] packToBytesBigEndian(long i,
                          byte[] r)

Pack i into a byte buffer r using a big-endian encoding such that the most significant byte is in r[0].

Parameters:

r - The buffer

i - The value to be packed.

Returns:

r

packToBufferBigEndian

public static ByteBuffer packToBufferBigEndian(long i,
                               ByteBuffer r,
                               int index)

Pack i into a byte buffer r using a big-endian encoding such that the most significant byte is in r[index].

Parameters:

r - The buffer.

i - The value to be packed.

index - The starting index.

Returns:

r

packToBytesLittleEndianAllocate

public static byte[] packToBytesLittleEndianAllocate(long i)

Pack i into a byte buffer b using a little-endian encoding such that the least significant byte is in b[0].

Parameters:

i - The value to be packed.

Returns:

A byte buffer containing the packed integer data.

packToBytesLittleEndian

public static byte[] packToBytesLittleEndian(long i,
                             byte[] r)

Pack i into a byte buffer r using a little-endian encoding such that the least significant byte is in r[0].

Parameters:

r - The buffer

i - The value to be packed.

Returns:

r

packToBufferLittleEndian

public static ByteBuffer packToBufferLittleEndian(long i,
                                  ByteBuffer r,
                                  int index)

Pack i into a byte buffer r using a little-endian encoding such that the least significant byte is in r[index].

Parameters:

r - The buffer.

i - The value to be packed.

index - The starting index.

Returns:

r

packToBuffer

public static ByteBuffer packToBuffer(long i,
                      ByteBuffer r,
                      int index)

Pack i into a byte buffer r using the encoding returned by ByteBuffer.order(), starting at index.

Parameters:

r - The buffer.

i - The value to be packed.

index - The starting index.

Returns:

r

unpackFromBytesBigEndian

public static long unpackFromBytesBigEndian(byte[] buffer)

Unpack an integer from buffer assuming a big-endian encoding such that the most significant byte is in b[0].

The function throws NullPointerException if buffer == null and IllegalArgumentException if buffer.length is too small to contain a packed integer value of this size.

Parameters:

buffer - The buffer from which to unpack data

Returns:

A 64 bit integer value

unpackFromBufferBigEndian

public static long unpackFromBufferBigEndian(ByteBuffer buffer,
                             int index)

Unpack an integer from buffer assuming a big-endian encoding such that the most significant byte is in b[index].

Parameters:

index - The starting index in the buffer.

buffer - The buffer from which to unpack data.

Returns:

A 64 bit integer value.

unpackFromBuffer

public static long unpackFromBuffer(ByteBuffer buffer,
                    int index)

Unpack an integer from buffer using the encoding returned by ByteBuffer.order(), starting at index.

Parameters:

index - The starting index

buffer - The buffer from which to unpack data.

Returns:

A 32 bit integer value.

unpackFromBytesLittleEndian

public static long unpackFromBytesLittleEndian(byte[] buffer)

Unpack an integer from buffer assuming a little-endian encoding such that the least significant byte is in b[0].

The function throws NullPointerException if buffer == null and IllegalArgumentException if buffer.length is too small to contain a packed integer value of this size.

Parameters:

buffer - The buffer from which to unpack data

Returns:

A 64 bit integer value

unpackFromBufferLittleEndian

public static long unpackFromBufferLittleEndian(ByteBuffer buffer,
                                int index)

Unpack an integer from buffer assuming a little-endian encoding such that the least significant byte is in b[index] .

Parameters:

index - The starting index

buffer - The buffer from which to unpack data.

Returns:

A 64 bit integer value.