net.sf.sevenzipjbinding
Interface ISeekableStream

All Known Subinterfaces:

IInStream, IOutStream

All Known Implementing Classes:

ByteArrayStream, RandomAccessFileInStream, RandomAccessFileOutStream, VolumedArchiveInStream

public interface ISeekableStream

Interface for seekable streams (random access streams).

Since:

9.20-2.00

Author:

Boris Brodski

Field Summary

static int	SEEK_CUR Indicates, that the seek operation should be done from the current position (file pointer) of the stream.
static int	SEEK_END Indicates, that the seek operation should be done from the end of the stream.
static int	SEEK_SET Indicates, that the seek operation should be done from the beginning of the stream

Method Summary

long	seek(long offset, int seekOrigin) Move current location pointer to the new offset depending on seekOrigin. Note: depending on the archive format and the data size this method may be called from different threads.

Field Detail

SEEK_SET

static final int SEEK_SET

Indicates, that the seek operation should be done from the beginning of the stream

See Also:

Constant Field Values

SEEK_CUR

static final int SEEK_CUR

Indicates, that the seek operation should be done from the current position (file pointer) of the stream. Positive values move file pointer forward.

See Also:

Constant Field Values

SEEK_END

static final int SEEK_END

Indicates, that the seek operation should be done from the end of the stream. Positive offset values move file pointer over the end of the stream. For the read only streams it's equivalent reaching end of the stream while reading.

See Also:

Constant Field Values

Method Detail

seek

long seek(long offset,
          int seekOrigin)
          throws SevenZipException

Move current location pointer to the new offset depending on seekOrigin.

Note: depending on the archive format and the data size this method may be called from different threads. Synchronized implementation may be required.

Parameters:

offset - absolute or relative offset in the stream to move to

seekOrigin - on of three possible seek origins:

• SEEK_SET - offset is an absolute offset to move to,
• SEEK_CUR - offset is a relative offset to the current position in stream,
• SEEK_END - offset is an offset from the end of the stream

(offset <= 0).

Returns:

new absolute position in the stream.

Throws:

SevenZipException - in error case. If this method ends with an exception, the current operation will be reported to 7-Zip as failed. There are no guarantee, that there are no further call back methods will get called. The first and last thrown exceptions will be saved and thrown later on from the originally called method such as ISevenZipInArchive.extract() or SevenZip.openInArchive(). Up to four exceptions depending on the situation can be saved for further analysis. See SevenZipException and SevenZipException.printStackTraceExtended() for details.