Packages  This Package  Prev  Next  Index  

§2.2 Class BufferedOutputStream

public  class  java.io.BufferedOutputStream
    extends  java.io.FilterOutputStream  (I-§2.12)
{
        // Fields
    protected byte buf[];	§2.2.1
    protected int count;	§2.2.2

        // Constructors
    public BufferedOutputStream(OutputStream  out);	§2.2.3
    public BufferedOutputStream(OutputStream  out, int size);	§2.2.4

        // Methods
    public void flush();	§2.2.5
    public void write(byte  b[], int  off, int  len);	§2.2.6
    public void write(int  b);	§2.2.7
}
The class implements a buffered output stream. By setting up a such an output stream, an application can write bytes to the underlying output stream without necessarily causing a call to the underlying system for each byte written. The data is written into a buffer, and then written to the underlying stream if the buffer reaches its capacity, the buffer output stream is closed, or the buffer output stream is explicity flushed.


Fields

buf

protected byte buf[]
The buffer where data is stored.

count

protected int count
The number of valid bytes in the buffer.

Constructors

BufferedOutputStream

public BufferedOutputStream(OutputStream out)
Creates a new buffered output stream to write data to the specified underlying output stream with a default 512-byte buffer size.
Parameters:
out - the underlying output stream

BufferedOutputStream

public BufferedOutputStream(OutputStream out, int size)
Creates a new buffered output stream to write data to the specified underlying output stream with the specified buffer size.
Parameters:
out - the underlying output stream
size - the buffer size

Methods

flush

public void flush() throws IOException
Flushes this buffered output stream. This forces any buffered output bytes to be written out to the underlying output stream (I-§2.12.1).

Throws
IOException (I-§2.29)
If an I/O error occurs.
Overrides:
flush in class FilterOutputStream (I-§2.12.4).

write

public void write(byte b[], int off, int len) throws IOException
Writes len bytes from the specified byte array starting at offset off to this buffered output stream.
Parameters:
b - the data
off - the start offset in the data
len - the number of bytes to write
Throws
IOException (I-§2.29)
If an I/O error occurs.
Overrides:
write in class FilterOutputStream (I-§2.12.6).

write

public void write(int b) throws IOException
Writes the specified byte to this buffered output stream.
Parameters:
b - the byte to be written
Throws
IOException (I-§2.29)
If an I/O error occurs.
Overrides:
write in class FilterOutputStream (I-§2.12.7).

Packages  This Package  Prev  Next  Index
Java API Document (HTML generated by dkramer on April 22, 1996)
Copyright © 1996 Sun Microsystems, Inc. All rights reserved
Please send any comments or corrections to doug.kramer@sun.com