Package org.apache.commons.imaging.common

Class ByteConversions

  • public final class ByteConversions
extends java.lang.Object
    Convenience methods for converting data types to and from byte arrays.

    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      private ByteConversions()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      private static byte[] toBytes​(double[] values, int offset, int length, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(double[] values, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(double value, java.nio.ByteOrder byteOrder)  
      private static void toBytes​(double value, java.nio.ByteOrder byteOrder, byte[] result, int offset)  
      private static byte[] toBytes​(float[] values, int offset, int length, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(float[] values, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(float value, java.nio.ByteOrder byteOrder)  
      private static void toBytes​(float value, java.nio.ByteOrder byteOrder, byte[] result, int offset)  
      private static byte[] toBytes​(int[] values, int offset, int length, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(int[] values, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(int value, java.nio.ByteOrder byteOrder)  
      private static void toBytes​(int value, java.nio.ByteOrder byteOrder, byte[] result, int offset)  
      static byte[] toBytes​(long value, java.nio.ByteOrder byteOrder)
      Encodes an eight-byte (long) into an array of bytes based on the specified byte order.
      private static void toBytes​(long value, java.nio.ByteOrder byteOrder, byte[] result, int offset)  
      private static byte[] toBytes​(short[] values, int offset, int length, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(short[] values, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(short value, java.nio.ByteOrder byteOrder)  
      private static void toBytes​(short value, java.nio.ByteOrder byteOrder, byte[] result, int offset)  
      private static byte[] toBytes​(RationalNumber[] values, int offset, int length, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(RationalNumber[] values, java.nio.ByteOrder byteOrder)  
      static byte[] toBytes​(RationalNumber value, java.nio.ByteOrder byteOrder)  
      private static void toBytes​(RationalNumber value, java.nio.ByteOrder byteOrder, byte[] result, int offset)  
      private static double toDouble​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder)  
      static double toDouble​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static double[] toDoubles​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder)  
      static double[] toDoubles​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static float toFloat​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder)  
      static float toFloat​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static float[] toFloats​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder)  
      static float[] toFloats​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      static int toInt​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder)  
      static int toInt​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static int[] toInts​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder)  
      static int[] toInts​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static long toLong​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder)  
      static long toLong​(byte[] bytes, java.nio.ByteOrder byteOrder)
      Extracts an eight-byte long integer from the specified byte array.
      private static long[] toLongs​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder)  
      static long[] toLongs​(byte[] bytes, java.nio.ByteOrder byteOrder)
      Extracts an array of eight-byte long integers from the specified array of bytes.
      private static RationalNumber toRational​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder, boolean unsignedType)  
      static RationalNumber toRational​(byte[] bytes, java.nio.ByteOrder byteOrder, boolean unsignedType)
      Interprets the content of a specified bytes array to create an instance of the RationalNumber class.
      private static RationalNumber[] toRationals​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder, boolean unsignedType)  
      static RationalNumber[] toRationals​(byte[] bytes, java.nio.ByteOrder byteOrder, boolean unsignedType)  
      private static short toShort​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder)  
      static short toShort​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static short[] toShorts​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder)  
      static short[] toShorts​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      static int toUInt16​(byte[] bytes, int offset, java.nio.ByteOrder byteOrder)  
      static int toUInt16​(byte[] bytes, java.nio.ByteOrder byteOrder)  
      private static int[] toUInt16s​(byte[] bytes, int offset, int length, java.nio.ByteOrder byteOrder)  
      static int[] toUInt16s​(byte[] bytes, java.nio.ByteOrder byteOrder)  

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • ByteConversions

        private ByteConversions()

    • Method Detail

      • toBytes

        public static byte[] toBytes​(double value,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static void toBytes​(double value,
                            java.nio.ByteOrder byteOrder,
                            byte[] result,
                            int offset)

      • toBytes

        public static byte[] toBytes​(double[] values,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static byte[] toBytes​(double[] values,
                              int offset,
                              int length,
                              java.nio.ByteOrder byteOrder)

      • toBytes

        public static byte[] toBytes​(float value,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static void toBytes​(float value,
                            java.nio.ByteOrder byteOrder,
                            byte[] result,
                            int offset)

      • toBytes

        public static byte[] toBytes​(float[] values,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static byte[] toBytes​(float[] values,
                              int offset,
                              int length,
                              java.nio.ByteOrder byteOrder)

      • toBytes

        public static byte[] toBytes​(int value,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static void toBytes​(int value,
                            java.nio.ByteOrder byteOrder,
                            byte[] result,
                            int offset)

      • toBytes

        public static byte[] toBytes​(int[] values,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static byte[] toBytes​(int[] values,
                              int offset,
                              int length,
                              java.nio.ByteOrder byteOrder)

      • toBytes

        public static byte[] toBytes​(long value,
                             java.nio.ByteOrder byteOrder)
        Encodes an eight-byte (long) into an array of bytes based on the specified byte order.
        Parameters:
        value - a standard data primitive of type long
        byteOrder - the byte order to be used for encoding
        Returns:
        an array of length 8

      • toBytes

        private static void toBytes​(long value,
                            java.nio.ByteOrder byteOrder,
                            byte[] result,
                            int offset)

      • toBytes

        public static byte[] toBytes​(RationalNumber value,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static void toBytes​(RationalNumber value,
                            java.nio.ByteOrder byteOrder,
                            byte[] result,
                            int offset)

      • toBytes

        public static byte[] toBytes​(RationalNumber[] values,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static byte[] toBytes​(RationalNumber[] values,
                              int offset,
                              int length,
                              java.nio.ByteOrder byteOrder)

      • toBytes

        public static byte[] toBytes​(short value,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static void toBytes​(short value,
                            java.nio.ByteOrder byteOrder,
                            byte[] result,
                            int offset)

      • toBytes

        public static byte[] toBytes​(short[] values,
                             java.nio.ByteOrder byteOrder)

      • toBytes

        private static byte[] toBytes​(short[] values,
                              int offset,
                              int length,
                              java.nio.ByteOrder byteOrder)

      • toDouble

        public static double toDouble​(byte[] bytes,
                              java.nio.ByteOrder byteOrder)

      • toDouble

        private static double toDouble​(byte[] bytes,
                               int offset,
                               java.nio.ByteOrder byteOrder)

      • toDoubles

        public static double[] toDoubles​(byte[] bytes,
                                 java.nio.ByteOrder byteOrder)

      • toDoubles

        private static double[] toDoubles​(byte[] bytes,
                                  int offset,
                                  int length,
                                  java.nio.ByteOrder byteOrder)

      • toFloat

        public static float toFloat​(byte[] bytes,
                            java.nio.ByteOrder byteOrder)

      • toFloat

        private static float toFloat​(byte[] bytes,
                             int offset,
                             java.nio.ByteOrder byteOrder)

      • toFloats

        public static float[] toFloats​(byte[] bytes,
                               java.nio.ByteOrder byteOrder)

      • toFloats

        private static float[] toFloats​(byte[] bytes,
                                int offset,
                                int length,
                                java.nio.ByteOrder byteOrder)

      • toInt

        public static int toInt​(byte[] bytes,
                        java.nio.ByteOrder byteOrder)

      • toInt

        public static int toInt​(byte[] bytes,
                        int offset,
                        java.nio.ByteOrder byteOrder)

      • toInts

        public static int[] toInts​(byte[] bytes,
                           java.nio.ByteOrder byteOrder)

      • toInts

        private static int[] toInts​(byte[] bytes,
                            int offset,
                            int length,
                            java.nio.ByteOrder byteOrder)

      • toLong

        public static long toLong​(byte[] bytes,
                          java.nio.ByteOrder byteOrder)
        Extracts an eight-byte long integer from the specified byte array. This method assumes that the byte array is of sufficiently large size to encode a long integer.
        Parameters:
        bytes - an array of size at least 8
        byteOrder - the byte-order for interpreting the input bytes
        Returns:
        an eight-byte signed integer

      • toLong

        private static long toLong​(byte[] bytes,
                           int offset,
                           java.nio.ByteOrder byteOrder)

      • toLongs

        public static long[] toLongs​(byte[] bytes,
                             java.nio.ByteOrder byteOrder)
        Extracts an array of eight-byte long integers from the specified array of bytes. The size of the result array is computed based on the size of the input byte array.
        Parameters:
        bytes - a valid array
        byteOrder - the byte-order for interpreting the input bytes
        Returns:
        an array of zero or more eight-byte signed integers

      • toLongs

        private static long[] toLongs​(byte[] bytes,
                              int offset,
                              int length,
                              java.nio.ByteOrder byteOrder)

      • toRational

        public static RationalNumber toRational​(byte[] bytes,
                                        java.nio.ByteOrder byteOrder,
                                        boolean unsignedType)
        Interprets the content of a specified bytes array to create an instance of the RationalNumber class.
        Parameters:
        bytes - a valid array dimensioned to at least 8.
        byteOrder - the byte order for integer conversion
        unsignedType - indicates whether the extracted value is an unsigned type.
        Returns:
        a valid instance

      • toRational

        private static RationalNumber toRational​(byte[] bytes,
                                         int offset,
                                         java.nio.ByteOrder byteOrder,
                                         boolean unsignedType)

      • toRationals

        public static RationalNumber[] toRationals​(byte[] bytes,
                                           java.nio.ByteOrder byteOrder,
                                           boolean unsignedType)

      • toRationals

        private static RationalNumber[] toRationals​(byte[] bytes,
                                            int offset,
                                            int length,
                                            java.nio.ByteOrder byteOrder,
                                            boolean unsignedType)

      • toShort

        public static short toShort​(byte[] bytes,
                            java.nio.ByteOrder byteOrder)

      • toShort

        private static short toShort​(byte[] bytes,
                             int offset,
                             java.nio.ByteOrder byteOrder)

      • toShorts

        public static short[] toShorts​(byte[] bytes,
                               java.nio.ByteOrder byteOrder)

      • toShorts

        private static short[] toShorts​(byte[] bytes,
                                int offset,
                                int length,
                                java.nio.ByteOrder byteOrder)

      • toUInt16

        public static int toUInt16​(byte[] bytes,
                           java.nio.ByteOrder byteOrder)

      • toUInt16

        public static int toUInt16​(byte[] bytes,
                           int offset,
                           java.nio.ByteOrder byteOrder)

      • toUInt16s

        public static int[] toUInt16s​(byte[] bytes,
                              java.nio.ByteOrder byteOrder)

      • toUInt16s

        private static int[] toUInt16s​(byte[] bytes,
                               int offset,
                               int length,
                               java.nio.ByteOrder byteOrder)