Package org.symbol.sdk.utils

Class Converter

java.lang.Object
org.symbol.sdk.utils.Converter
public final class Converter extends Object
Converter

Hex / integer / byte conversion helpers.

  • Method Summary

    Modifier and Type
    Method
    Description
    static long
    bytesToInt(byte[] input, int size)
    Converts little-endian bytes to a long for any size (1, 2, 4 or 8); a size-8 u64 >= 2^63 reads back negative.
    static long
    bytesToInt(byte[] input, int size, boolean isSigned)
    Converts bytes to a long for any size (1, 2, 4 or 8); a size-8 u64 >= 2^63 reads back negative.
    static long
    bytesToInt(byte[] input, int offset, int size, boolean isSigned)
    Converts bytes to a long for any size (1, 2, 4 or 8); a size-8 u64 >= 2^63 reads back negative.
    static byte[]
    hexToUint8(String input)
    Converts a hex string to a byte array.
    static byte[]
    intToBytes(long value, int byteSize)
    Converts an integer to bytes by truncating its 64-bit two's-complement encoding to byteSize.
    static boolean
    isHexString(String input)
    Determines whether a string is a hex string.
    static int
    toInt(Number value)
    Converts a fixed-width integral wrapper to a 32-bit int bit pattern, accepting the signed int range and the full unsigned 32-bit range (a magnitude >= 2^31 yields the negative two's-complement pattern).
    static int
    toInt(String value)
    Parses a string to a 32-bit int bit pattern, the 32-bit analogue of toLong(String): a 0x-prefixed hex string or a non-negative decimal is read across the full unsigned 32-bit range (a value >= 2^31 yields the negative two's-complement pattern), while a --prefixed decimal is parsed signed.
    static long
    toLong(Number value)
    Converts a fixed-width integral wrapper (Integer/Long/Short/Byte) or an unsigned-64-bit-range BigInteger to a 64-bit long; any other type is rejected.
    static long
    toLong(String value)
    Parses a string to a 64-bit long bit pattern: a 0x/0X-prefixed hex string or a non-negative decimal is read across the full unsigned range (a value >= 2^63 yields the negative two's-complement pattern), while a --prefixed decimal is parsed signed — so, like toLong(Number), negatives are accepted.
    static String
    uint8ToHex(byte[] input)
    Converts a byte array to a hex string.

    Methods inherited from class java.lang.Object

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

  • Method Details

    • isHexString

      public static boolean isHexString(String input)
      Converter.isHexString

      Determines whether a string is a hex string.

      Parameters:

      input - String to test.

      Returns:

      true if the input is a hex string, false otherwise.

    • hexToUint8

      public static byte[] hexToUint8(String input)
      Converter.hexToUint8

      Converts a hex string to a byte array.

      Parameters:

      input - Hex encoded string.

      Returns:

      Byte array corresponding to the input.

    • uint8ToHex

      public static String uint8ToHex(byte[] input)
      Converter.uint8ToHex

      Converts a byte array to a hex string.

      Parameters:

      input - Byte array.

      Returns:

      Hex encoded string corresponding to the input.

    • bytesToInt

      public static long bytesToInt(byte[] input, int size, boolean isSigned)
      Converter.bytesToInt

      Converts bytes to a long for any size (1, 2, 4 or 8); a size-8 u64 >= 2^63 reads back negative.

      Parameters:

      input - Byte array.

      size - Number of bytes (1, 2, 4 or 8).

      isSigned - true if a value narrower than 8 bytes should be sign-extended.

      Returns:

      Value corresponding to the input.

    • bytesToInt

      public static long bytesToInt(byte[] input, int offset, int size, boolean isSigned)
      Converter.bytesToInt

      Converts bytes to a long for any size (1, 2, 4 or 8); a size-8 u64 >= 2^63 reads back negative.

      Parameters:

      input - Byte array.

      offset - Offset into the array at which to start reading.

      size - Number of bytes (1, 2, 4 or 8).

      isSigned - true if a value narrower than 8 bytes should be sign-extended.

      Returns:

      Value corresponding to the input.

    • bytesToInt

      public static long bytesToInt(byte[] input, int size)
      Converter.bytesToInt

      Converts little-endian bytes to a long for any size (1, 2, 4 or 8); a size-8 u64 >= 2^63 reads back negative.

      Parameters:

      input - Byte array.

      size - Number of bytes (1, 2, 4 or 8).

      Returns:

      Unsigned value.

    • intToBytes

      public static byte[] intToBytes(long value, int byteSize)
      Converter.intToBytes

      Converts an integer to bytes by truncating its 64-bit two's-complement encoding to byteSize.

      Parameters:

      value - Integer value.

      byteSize - Number of output bytes.

      Returns:

      Byte representation of the integer.

    • toLong

      public static long toLong(String value)
      Converter.toLong

      Parses a string to a 64-bit long bit pattern: a 0x/0X-prefixed hex string or a non-negative decimal is read across the full unsigned range (a value >= 2^63 yields the negative two's-complement pattern), while a --prefixed decimal is parsed signed — so, like toLong(Number), negatives are accepted.

      Parameters:

      value - String value (signed/unsigned decimal, or 0x-prefixed hexadecimal).

      Returns:

      Parsed value as a 64-bit two's-complement bit pattern.

      Throws:

      IllegalArgumentException - If the string is not a valid integer that fits a 64-bit pattern.

    • toLong

      public static long toLong(Number value)
      Converter.toLong

      Converts a fixed-width integral wrapper (Integer/Long/Short/Byte) or an unsigned-64-bit-range BigInteger to a 64-bit long; any other type is rejected.

      Parameters:

      value - Integral descriptor number.

      Returns:

      Converted value as a 64-bit two's-complement bit pattern.

      Throws:

      IllegalArgumentException - If the value is not an integral number fitting a 64-bit pattern.

    • toInt

      public static int toInt(Number value)
      Converter.toInt

      Converts a fixed-width integral wrapper to a 32-bit int bit pattern, accepting the signed int range and the full unsigned 32-bit range (a magnitude >= 2^31 yields the negative two's-complement pattern). Anything outside [Integer.MIN_VALUE, 2^32 - 1] is rejected rather than truncated.

      Parameters:

      value - Integral descriptor number.

      Returns:

      Converted value as a 32-bit two's-complement bit pattern.

      Throws:

      IllegalArgumentException - If the value does not fit a 32-bit pattern (or is not an integral wrapper).

    • toInt

      public static int toInt(String value)
      Converter.toInt

      Parses a string to a 32-bit int bit pattern, the 32-bit analogue of toLong(String): a 0x-prefixed hex string or a non-negative decimal is read across the full unsigned 32-bit range (a value >= 2^31 yields the negative two's-complement pattern), while a --prefixed decimal is parsed signed. Anything outside the unsigned 32-bit range is rejected rather than truncated.

      Parameters:

      value - String value (signed/unsigned decimal, or 0x-prefixed hexadecimal).

      Returns:

      Parsed value as a 32-bit two's-complement bit pattern.

      Throws:

      IllegalArgumentException - If the string is unparseable or does not fit a 32-bit pattern.