Package 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 Details

    • 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.