java.lang.Object | |
↳ | java.io.OutputStream |
Known Direct Subclasses |
A writable sink for bytes.
Most clients will use output streams that write data to the file system
(FileOutputStream
), the network (getOutputStream()
/getOutputStream()
), or to an in-memory byte array
(ByteArrayOutputStream
).
Use OutputStreamWriter
to adapt a byte stream like this one into a
character stream.
Most clients should wrap their output stream with BufferedOutputStream
. Callers that do only bulk writes may omit buffering.
FilterOutputStream
, which delegates all calls to the target output
stream.
All output stream subclasses should override both write(int)
and write(byte[],int,int)
. The
three argument overload is necessary for bulk access to the data. This is
much more efficient than byte-by-byte access.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Default constructor.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Closes this stream.
| |||||||||||
Flushes this stream.
| |||||||||||
Writes
count bytes from the byte array buffer starting at
position offset to this stream. | |||||||||||
Equivalent to
write(buffer, 0, buffer.length) . | |||||||||||
Writes a single byte to this stream.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
java.io.Closeable
| |||||||||||
From interface
java.io.Flushable
| |||||||||||
From interface
java.lang.AutoCloseable
|
Closes this stream. Implementations of this method should free any resources used by the stream. This implementation does nothing.
IOException | if an error occurs while closing this stream. |
---|
Flushes this stream. Implementations of this method should ensure that any buffered data is written out. This implementation does nothing.
IOException | if an error occurs while flushing this stream. |
---|
Writes count
bytes from the byte array buffer
starting at
position offset
to this stream.
buffer | the buffer to be written. |
---|---|
offset | the start position in buffer from where to get bytes. |
count | the number of bytes from buffer to write to this
stream. |
IOException | if an error occurs while writing to this stream. |
---|---|
IndexOutOfBoundsException | if offset < 0 or count < 0 , or if
offset + count is bigger than the length of
buffer .
|
Equivalent to write(buffer, 0, buffer.length)
.
IOException |
---|
Writes a single byte to this stream. Only the least significant byte of
the integer oneByte
is written to the stream.
oneByte | the byte to be written. |
---|
IOException | if an error occurs while writing to this stream. |
---|