Package org.apache.poi.util

Class LongField

  • All Implemented Interfaces:
    FixedField
    public class LongField
extends java.lang.Object
implements FixedField
    representation of a long (16-bit) field at a fixed location within a byte array

    • Constructor Summary

      Constructors 
      Constructor Description
      LongField​(int offset)
      construct the LongField with its offset into its containing byte array
      LongField​(int offset, byte[] data)
      Construct the LongField with its offset into its containing byte array and initialize its value from its byte array
      LongField​(int offset, long value)
      construct the LongField with its offset into its containing byte array and initialize its value
      LongField​(int offset, long value, byte[] data)
      construct the LongField with its offset into its containing byte array, initialize its value, and write the value to a byte array

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      long get()
      get the LongField's current value
      void readFromBytes​(byte[] data)
      set the value from its offset into an array of bytes
      void readFromStream​(java.io.InputStream stream)
      set the value from an InputStream
      void set​(long value)
      set the LongField's current value
      void set​(long value, byte[] data)
      set the LongField's current value and write it to a byte array
      java.lang.String toString()
      return the value as a String
      void writeToBytes​(byte[] data)
      write the value out to an array of bytes at the appropriate offset

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

    • Constructor Detail

      • LongField

        public LongField​(int offset)
          throws java.lang.ArrayIndexOutOfBoundsException
        construct the LongField with its offset into its containing byte array
        Parameters:
        offset - of the field within its byte array
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if offset is negative

      • LongField

        public LongField​(int offset,
                 long value)
          throws java.lang.ArrayIndexOutOfBoundsException
        construct the LongField with its offset into its containing byte array and initialize its value
        Parameters:
        offset - of the field within its byte array
        value - the initial value
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if offset is negative

      • LongField

        public LongField​(int offset,
                 byte[] data)
          throws java.lang.ArrayIndexOutOfBoundsException
        Construct the LongField with its offset into its containing byte array and initialize its value from its byte array
        Parameters:
        offset - of the field within its byte array
        data - the byte array to read the value from
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if the offset is not within the range of 0..(data.length - 1)

      • LongField

        public LongField​(int offset,
                 long value,
                 byte[] data)
          throws java.lang.ArrayIndexOutOfBoundsException
        construct the LongField with its offset into its containing byte array, initialize its value, and write the value to a byte array
        Parameters:
        offset - of the field within its byte array
        value - the initial value
        data - the byte array to write the value to
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if offset is negative

    • Method Detail

      • get

        public long get()
        get the LongField's current value
        Returns:
        current value

      • set

        public void set​(long value)
        set the LongField's current value
        Parameters:
        value - to be set

      • set

        public void set​(long value,
                byte[] data)
         throws java.lang.ArrayIndexOutOfBoundsException
        set the LongField's current value and write it to a byte array
        Parameters:
        value - to be set
        data - the byte array to write the value to
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if the offset is out of range

      • readFromBytes

        public void readFromBytes​(byte[] data)
                   throws java.lang.ArrayIndexOutOfBoundsException
        set the value from its offset into an array of bytes
        Specified by:
        readFromBytes in interface FixedField
        Parameters:
        data - the byte array from which the value is to be read
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if the offset is out of range

      • readFromStream

        public void readFromStream​(java.io.InputStream stream)
                    throws java.io.IOException
        set the value from an InputStream
        Specified by:
        readFromStream in interface FixedField
        Parameters:
        stream - the InputStream from which the value is to be read
        Throws:
        LittleEndian.BufferUnderrunException - if there is not enough data available from the InputStream
        java.io.IOException - if an IOException is thrown from reading the InputStream

      • writeToBytes

        public void writeToBytes​(byte[] data)
                  throws java.lang.ArrayIndexOutOfBoundsException
        write the value out to an array of bytes at the appropriate offset
        Specified by:
        writeToBytes in interface FixedField
        Parameters:
        data - the array of bytes to which the value is to be written
        Throws:
        java.lang.ArrayIndexOutOfBoundsException - if the offset is out of range

      • toString

        public java.lang.String toString()
        return the value as a String
        Specified by:
        toString in interface FixedField
        Overrides:
        toString in class java.lang.Object
        Returns:
        the value as a String