Package org.python.core.io
Class BufferedReader
java.lang.Object
org.python.core.io.IOBase
org.python.core.io.BufferedIOBase
org.python.core.io.BufferedIOMixin
org.python.core.io.BufferedReader
Buffer for a readable sequential RawIO object.
- Author:
- Philip Jenvey
-
Field Summary
Fields inherited from class org.python.core.io.IOBase
DEFAULT_BUFFER_SIZE -
Constructor Summary
ConstructorsConstructorDescriptionBufferedReader(RawIOBase rawIO, int bufferSize) Construct a BufferedReader of bufferSize, wrapping the given RawIOBase. -
Method Summary
Modifier and TypeMethodDescriptionbooleanbuffered()Return true if this objects buffer contains any data.voidclear()Clear the read buffer if one exists.peek(int size) Returns buffered bytes without advancing the position.intread1(ByteBuffer bytes) Reads up to bytes.remaining() bytes.readall()Read until EOF.intreadinto(ByteBuffer bytes) Read up to bytes.remaining() bytes into the given ByteBuffer.longseek(long pos, int whence) Seek to byte offsetposrelative to position indicated bywhence.longtell()Return the current stream position.booleanwritable()Return whether this file was opened for writing.intwrite(ByteBuffer bytes) Write the given ByteBuffer to the IO stream.Methods inherited from class org.python.core.io.BufferedIOMixin
asInputStream, asOutputStream, close, closed, fileno, flush, isatty, readable, truncateMethods inherited from class org.python.core.io.BufferedIOBase
readMethods inherited from class org.python.core.io.IOBase
checkClosed, checkReadable, checkWritable, seek
-
Constructor Details
-
BufferedReader
Construct a BufferedReader of bufferSize, wrapping the given RawIOBase.- Parameters:
rawIO-bufferSize-
-
-
Method Details
-
readinto
Description copied from class:BufferedIOBaseRead up to bytes.remaining() bytes into the given ByteBuffer. Returns number of bytes read (0 for EOF).- Overrides:
readintoin classBufferedIOBase- Parameters:
bytes- a ByteBuffer to read bytes into- Returns:
- the amount of data read as an int
-
readall
Description copied from class:BufferedIOBaseRead until EOF.- Overrides:
readallin classBufferedIOBase- Returns:
- a ByteBuffer containing the bytes read
-
peek
Description copied from class:BufferedIOBaseReturns buffered bytes without advancing the position. The argument indicates a desired minimal number of bytes; we do at most one raw read to satisfy it. We never return more than the size of the underlying buffer;- Overrides:
peekin classBufferedIOBase- Parameters:
size- the minimal number of bytes as an int- Returns:
- a ByteBuffer containing the bytes read
-
read1
Description copied from class:BufferedIOBaseReads up to bytes.remaining() bytes. Returns up to bytes.remaining() bytes. If at least one byte is buffered, we only return buffered bytes. Otherwise, we do one raw read.- Overrides:
read1in classBufferedIOBase- Parameters:
bytes- a ByteBuffer to read bytes into- Returns:
- the amount of data read as an int
-
tell
public long tell()Description copied from class:IOBaseReturn the current stream position.- Overrides:
tellin classBufferedIOMixin- Returns:
- a long position value
-
seek
public long seek(long pos, int whence) Description copied from class:IOBaseSeek to byte offsetposrelative to position indicated bywhence.
Returns the new absolute position.Semantics whenceSeek to pos0 Start of stream (the default). Should be ≥0. 1 Current position + posEither sign. 2 End of stream + posUsually ≤0. - Overrides:
seekin classBufferedIOMixin- Parameters:
pos- a long position valuewhence- an int whence value- Returns:
- a long position value seeked to
-
buffered
public boolean buffered()Description copied from class:BufferedIOBaseReturn true if this objects buffer contains any data.- Overrides:
bufferedin classBufferedIOBase- Returns:
- boolean whether or not any data is currently buffered
-
clear
public void clear()Description copied from class:BufferedIOBaseClear the read buffer if one exists.- Overrides:
clearin classBufferedIOBase
-
write
Description copied from class:BufferedIOBaseWrite the given ByteBuffer to the IO stream. Returns the number of bytes written, which may be less than bytes.remaining().- Overrides:
writein classBufferedIOBase- Parameters:
bytes- a ByteBuffer value- Returns:
- the number of bytes written as an int
-
writable
public boolean writable()Description copied from class:IOBaseReturn whether this file was opened for writing.- Overrides:
writablein classBufferedIOMixin- Returns:
- true if the file was opened for writing
-