加载中...
The Wayback Machine - https://sup1a9wrlpyh5li9ro.vcoronado.top/web/20090307030009/http://developer.android.com:80/reference/java/io/OutputStreamWriter.html
public class

OutputStreamWriter

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

Class Overview

OutputStreamWriter is a class for turning a character output stream into a byte output stream. The conversion of Unicode characters to their byte equivalents is determined by the converter used. By default, the encoding is ISO8859_1 (ISO-Latin-1) but can be changed by calling the constructor which takes an encoding.

See Also

Summary

[Expand]
Inherited Fields
From class java.io.Writer
Public Constructors
OutputStreamWriter(OutputStream out)
Constructs a new OutputStreamWriter using out as the OutputStream to write converted characters to.
OutputStreamWriter(OutputStream out, String enc)
Constructs a new OutputStreamWriter using out as the OutputStream to write converted characters to and enc as the character encoding.
OutputStreamWriter(OutputStream out, Charset cs)
Constructs a new OutputStreamWriter using out as the OutputStream to write converted characters to and cs as the character encoding.
OutputStreamWriter(OutputStream out, CharsetEncoder enc)
Constructs a new OutputStreamWriter using out as the OutputStream to write converted characters to and enc as the character encoding.
Public Methods
void close()
Close this OutputStreamWriter.
void flush()
Flush this OutputStreamWriter.
String getEncoding()
Answer the String which identifies the encoding used to convert characters to bytes.
void write(char[] buf, 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 out 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)

Constructs a new OutputStreamWriter using out as the OutputStream to write converted characters to. The default character encoding is used (see class description).

Parameters
out the non-null OutputStream to write converted bytes to.

public OutputStreamWriter (OutputStream out, String enc)

Constructs a new OutputStreamWriter using out as the OutputStream 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 non-null OutputStream to write converted bytes to.
enc the non-null String describing the desired character encoding.
Throws
UnsupportedEncodingException if the encoding cannot be found.

public OutputStreamWriter (OutputStream out, Charset cs)

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

Parameters
out the non-null OutputStream to write converted bytes to.
cs the non-null Charset which specify the character encoding.

public OutputStreamWriter (OutputStream out, CharsetEncoder enc)

Constructs a new OutputStreamWriter using out as the OutputStream to write converted characters to and enc as the character encoding.

Parameters
out the non-null OutputStream to write converted bytes to.
enc the non-null CharsetEncoder which used to character encoding.

Public Methods

public void close ()

Close this OutputStreamWriter. This implementation first flushes the buffer and the target OutputStream. The OutputStream is then closed and the resources for the buffer and converter are freed.

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

Throws
IOException If an error occurs attempting to close this OutputStreamWriter.

public void flush ()

Flush this OutputStreamWriter. This implementation ensures all buffered bytes are written to the target OutputStream. After writing the bytes, the target OutputStream is then flushed.

Throws
IOException If an error occurs attempting to flush this OutputStreamWriter.

public String getEncoding ()

Answer the String which identifies the encoding used to convert characters to bytes. The value null is returned if this Writer has been closed.

Returns
  • the String describing the converter or null if this Writer is closed.

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

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 becomes full as a result of this write, this Writer is flushed.

Parameters
buf the non-null array containing characters to write.
offset offset in buf to retrieve characters
count maximum number of characters to write
Throws
IOException If this OutputStreamWriter has already been closed or some other IOException occurs.
IndexOutOfBoundsException If offset or count is outside of bounds.

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

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 becomes full as a result of this write, this Writer is flushed.

Parameters
str the non-null String containing characters to write.
offset offset in str to retrieve characters
count maximum number of characters to write
Throws
IOException If this OutputStreamWriter has already been closed or some other IOException occurs.
IndexOutOfBoundsException If count is negative
StringIndexOutOfBoundsException If offset is negative or offset + count is outside of bounds

public void write (int oneChar)

Writes out the character oneChar to this Writer. The low-order 2 bytes are immediately converted to bytes by the character converter and stored in a local buffer. If the buffer becomes full as a result of this write, this Writer is flushed.

Parameters
oneChar the character to write
Throws
IOException If this OutputStreamWriter has already been closed or some other IOException occurs.