public class

OutputStreamWriter

extends Writer
java.lang.Object
   ↳ java.io.Writer
     ↳ java.io.OutputStreamWriter
Known Direct Subclasses

Class Overview

A class for turning a character stream into a byte stream. Data written to the target input stream is converted into bytes by either a default or a provided character converter. The default encoding is taken from the "file.encoding" system property. OutputStreamWriter contains a buffer of bytes to be written to target stream and converts these into characters as needed. The buffer size is 8K.

See Also

Summary

[Expand]
Inherited Fields
From class java.io.Writer
Public Constructors
OutputStreamWriter(OutputStream out)
Constructs a new OutputStreamWriter using out as the target stream to write converted characters to.
OutputStreamWriter(OutputStream out, String enc)
Constructs a new OutputStreamWriter using out as the target stream to write converted characters to and enc as the character encoding.
OutputStreamWriter(OutputStream out, Charset cs)
Constructs a new OutputStreamWriter using out as the target stream to write converted characters to and cs as the character encoding.
OutputStreamWriter(OutputStream out, CharsetEncoder enc)
Constructs a new OutputStreamWriter using out as the target stream to write converted characters to and enc as the character encoder.
Public Methods
void close()
Closes this writer.
void flush()
Flushes this writer.
String getEncoding()
Returns the historical name of the encoding used by this writer to convert characters to bytes, or null if this writer has been closed.
void write(char[] buffer, int offset, int count)
Writes count characters starting at offset in buf to this writer.
void write(String str, int offset, int count)
Writes count characters starting at offset in str to this writer.
void write(int oneChar)
Writes the character oneChar to this writer.
[Expand]
Inherited Methods
From class java.io.Writer
From class java.lang.Object
From interface java.io.Closeable
From interface java.io.Flushable
From interface java.lang.Appendable

Public Constructors

public OutputStreamWriter (OutputStream out)

Since: API Level 1

Constructs a new OutputStreamWriter using out as the target stream to write converted characters to. The default character encoding is used.

Parameters
out the non-null target stream to write converted bytes to.

public OutputStreamWriter (OutputStream out, String enc)

Since: API Level 1

Constructs a new OutputStreamWriter using out as the target stream to write converted characters to and enc as the character encoding. If the encoding cannot be found, an UnsupportedEncodingException error is thrown.

Parameters
out the target stream to write converted bytes to.
enc the string describing the desired character encoding.
Throws
NullPointerException if enc is null.
UnsupportedEncodingException if the encoding specified by enc cannot be found.

public OutputStreamWriter (OutputStream out, Charset cs)

Since: API Level 1

Constructs a new OutputStreamWriter using out as the target stream to write converted characters to and cs as the character encoding.

Parameters
out the target stream to write converted bytes to.
cs the Charset that specifies the character encoding.

public OutputStreamWriter (OutputStream out, CharsetEncoder enc)

Since: API Level 1

Constructs a new OutputStreamWriter using out as the target stream to write converted characters to and enc as the character encoder.

Parameters
out the target stream to write converted bytes to.
enc the character encoder used for character conversion.

Public Methods

public void close ()

Since: API Level 1

Closes this writer. This implementation flushes the buffer as well as the target stream. The target stream is then closed and the resources for the buffer and converter are released.

Only the first invocation of this method has any effect. Subsequent calls do nothing.

Throws
IOException if an error occurs while closing this writer.

public void flush ()

Since: API Level 1

Flushes this writer. This implementation ensures that all buffered bytes are written to the target stream. After writing the bytes, the target stream is flushed as well.

Throws
IOException if an error occurs while flushing this writer.

public String getEncoding ()

Since: API Level 1

Returns the historical name of the encoding used by this writer to convert characters to bytes, or null if this writer has been closed. Most callers should probably keep track of the String or Charset they passed in; this method may not return the same name.

public void write (char[] buffer, int offset, int count)

Since: API Level 1

Writes count characters starting at offset in buf to this writer. The characters are immediately converted to bytes by the character converter and stored in a local buffer. If the buffer gets full as a result of the conversion, this writer is flushed.

Parameters
buffer the array containing characters to write.
offset the index of the first character in buf to write.
count the maximum number of characters to write.
Throws
IndexOutOfBoundsException if offset < 0 or count < 0, or if offset + count is greater than the size of buf.
IOException if this writer has already been closed or another I/O error occurs.

public void write (String str, int offset, int count)

Since: API Level 1

Writes count characters starting at offset in str to this writer. The characters are immediately converted to bytes by the character converter and stored in a local buffer. If the buffer gets full as a result of the conversion, this writer is flushed.

Parameters
str the string containing characters to write.
offset the start position in str for retrieving characters.
count the maximum number of characters to write.
Throws
IOException if this writer has already been closed or another I/O error occurs.
IndexOutOfBoundsException if offset < 0 or count < 0, or if offset + count is bigger than the length of str.

public void write (int oneChar)

Since: API Level 1

Writes the character oneChar to this writer. The lowest two bytes of the integer oneChar are immediately converted to bytes by the character converter and stored in a local buffer. If the buffer gets full by converting this character, this writer is flushed.

Parameters
oneChar the character to write.
Throws
IOException if this writer is closed or another I/O error occurs.