Package ghidra.app.util.bin

Class EmptyByteProvider

java.lang.Object
ghidra.app.util.bin.EmptyByteProvider
All Implemented Interfaces:
ByteProvider, Closeable, AutoCloseable
public class EmptyByteProvider extends Object implements ByteProvider
A ByteProvider that has no contents.

  • Constructor Details

    • EmptyByteProvider

      public EmptyByteProvider()
      Create an instance with a null identity

    • EmptyByteProvider

      public EmptyByteProvider(FSRL fsrl)
      Create an instance with the specified FSRL identity.
      Parameters:
      fsrl - FSRL identity for this instance

  • Method Details

    • getFSRL

      public FSRL getFSRL()
      Description copied from interface: ByteProvider
      Returns the FSRL of the underlying file for this byte provider, or null if this byte provider is not associated with a file.
      Specified by:
      getFSRL in interface ByteProvider
      Returns:
      The FSRL of the underlying File, or null if no associated File.

    • getFile

      public File getFile()
      Description copied from interface: ByteProvider
      Returns the underlying File for this ByteProvider, or null if this ByteProvider is not associated with a File.
      Specified by:
      getFile in interface ByteProvider
      Returns:
      the underlying file for this byte provider

    • getName

      public String getName()
      Description copied from interface: ByteProvider
      Returns the name of the ByteProvider. For example, the underlying file name.
      Specified by:
      getName in interface ByteProvider
      Returns:
      the name of the ByteProvider or null if there is no name

    • getAbsolutePath

      public String getAbsolutePath()
      Description copied from interface: ByteProvider
      Returns the absolute path (similar to, but not a, URI) to the ByteProvider. For example, the complete path to the file.
      Specified by:
      getAbsolutePath in interface ByteProvider
      Returns:
      the absolute path to the ByteProvider or null if not associated with a File.

    • readByte

      public byte readByte(long index) throws IOException
      Description copied from interface: ByteProvider
      Reads a byte at the specified index
      Specified by:
      readByte in interface ByteProvider
      Parameters:
      index - the index of the byte to read
      Returns:
      the byte read from the specified index
      Throws:
      IOException - if an I/O error occurs

    • readBytes

      public byte[] readBytes(long index, long length) throws IOException
      Description copied from interface: ByteProvider
      Reads a byte array at the specified index
      Specified by:
      readBytes in interface ByteProvider
      Parameters:
      index - the index of the byte to read
      length - the number of bytes to read
      Returns:
      the byte array read from the specified index
      Throws:
      IOException - if an I/O error occurs

    • length

      public long length()
      Description copied from interface: ByteProvider
      Returns the length of the ByteProvider
      Specified by:
      length in interface ByteProvider
      Returns:
      the length of the ByteProvider

    • isEmpty

      public boolean isEmpty()
      Description copied from interface: ByteProvider
      Returns true if this ByteProvider does not contain any bytes.
      Specified by:
      isEmpty in interface ByteProvider
      Returns:
      boolean true if this provider is empty, false if contains bytes

    • isValidIndex

      public boolean isValidIndex(long index)
      Description copied from interface: ByteProvider
      Returns true if the specified index is valid.
      Specified by:
      isValidIndex in interface ByteProvider
      Parameters:
      index - the index in the byte provider to check
      Returns:
      true if the specified index is valid

    • close

      public void close() throws IOException
      Description copied from interface: ByteProvider
      Releases any resources the ByteProvider may have occupied
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface ByteProvider
      Specified by:
      close in interface Closeable
      Throws:
      IOException - if an I/O error occurs

    • getInputStream

      public InputStream getInputStream(long index) throws IOException
      Description copied from interface: ByteProvider
      Returns an input stream to the underlying byte provider starting at the specified index.

      The caller is responsible for closing the returned InputStream instance.

      If you need to override this default implementation, please document why your inputstream is needed.

      Specified by:
      getInputStream in interface ByteProvider
      Parameters:
      index - where in the ByteProvider to start the InputStream
      Returns:
      the InputStream
      Throws:
      IOException - if an I/O error occurs