Package org.apache.pdfbox.pdfparser
Interface SequentialSource
- All Superinterfaces:
AutoCloseable
,Closeable
- All Known Implementing Classes:
InputStreamSource
,RandomAccessSource
A SequentialSource provides access to sequential data for parsing.
-
Method Summary
Modifier and TypeMethodDescriptionlong
Returns offset of next byte to be returned by a read method.boolean
isClosed()
Returns true if this source has been closed.boolean
isEOF()
Returns true if the end of the data source has been reached.int
peek()
This will peek at the next byte.int
read()
Read a single byte of data.int
read
(byte[] b) Read a buffer of data.int
read
(byte[] b, int offset, int length) Read a buffer of data.byte[]
readFully
(int length) Reads a given number of bytes in its entirety.void
unread
(byte[] bytes) Unreads an array of bytes.void
unread
(byte[] bytes, int start, int len) Unreads a portion of an array of bytes.void
unread
(int b) Unreads a single byte.
-
Method Details
-
read
Read a single byte of data.- Returns:
- The byte of data that is being read.
- Throws:
IOException
- If there is an error while reading the data.
-
read
Read a buffer of data.- Parameters:
b
- The buffer to write the data to.- Returns:
- The number of bytes that were actually read.
- Throws:
IOException
- If there was an error while reading the data.
-
read
Read a buffer of data.- Parameters:
b
- The buffer to write the data to.offset
- Offset into the buffer to start writing.length
- The amount of data to attempt to read.- Returns:
- The number of bytes that were actually read.
- Throws:
IOException
- If there was an error while reading the data.
-
getPosition
Returns offset of next byte to be returned by a read method.- Returns:
- offset of next byte which will be returned with next
read()
(if no more bytes are left it returns a value >= length of source). - Throws:
IOException
- If there was an error while reading the data.
-
peek
This will peek at the next byte.- Returns:
- The next byte on the stream, leaving it as available to read.
- Throws:
IOException
- If there is an error reading the next byte.
-
unread
Unreads a single byte.- Parameters:
b
- byte array to push back- Throws:
IOException
- if there is an error while unreading
-
unread
Unreads an array of bytes.- Parameters:
bytes
- byte array to be unread- Throws:
IOException
- if there is an error while unreading
-
unread
Unreads a portion of an array of bytes.- Parameters:
bytes
- byte array to be unreadstart
- start indexlen
- number of bytes to be unread- Throws:
IOException
- if there is an error while unreading
-
readFully
Reads a given number of bytes in its entirety.- Parameters:
length
- the number of bytes to be read- Returns:
- a byte array containing the bytes just read
- Throws:
IOException
- if an I/O error occurs while reading data
-
isEOF
Returns true if the end of the data source has been reached.- Returns:
- true if we are at the end of the data.
- Throws:
IOException
- If there is an error reading the next byte.
-
isClosed
Returns true if this source has been closed.- Returns:
- true if the source has been closed
- Throws:
IOException
-