Index (Frames) | Index (No Frames) | Package | Package Tree | Tree
java.io

Class OutputStreamWriter

java.lang.Object
|
+--java.io.Writer
   |
   +--java.io.OutputStreamWriter


public class OutputStreamWriter

extends Writer

This class writes characters to an output stream that is byte oriented It converts the chars that are written to bytes using an encoding layer, which is specific to a particular encoding standard. The desired encoding can either be specified by name, or if no encoding is specified, the system default encoding will be used. The system default encoding name is determined from the system property file.encoding. The only encodings that are guaranteed to be available are "8859_1" (the Latin-1 character set) and "UTF8". Unfortunately, Java does not provide a mechanism for listing the encodings that are supported in a given implementation.

Here is a list of standard encoding names that may be available:

Author:

Constructor Summary

OutputStreamWriter(java.io.OutputStream out)

This method initializes a new instance of OutputStreamWriter to write to the specified stream using the default encoding.
OutputStreamWriter(java.io.OutputStream out, java.lang.String encoding_scheme)

This method initializes a new instance of OutputStreamWriter to write to the specified stream using a caller supplied character encoding scheme.

Method Summary

voidclose()

This method closes this stream, and the underlying OutputStream
voidflush()

This method flushes any buffered bytes to the underlying output sink.
java.lang.StringgetEncoding()

This method returns the name of the character encoding scheme currently in use by this stream.
voidwrite(int c)

This method writes a single character to the output stream.
voidwrite(char[] buf, int offset, int len)

This method writes len characters from the specified array to the output stream starting at position offset into the array.
voidwrite(java.lang.String str, int offset, int len)

This method writes len bytes from the specified String starting at position offset into the String.

Constructor Details

OutputStreamWriter

public OutputStreamWriter(java.io.OutputStream out)

This method initializes a new instance of OutputStreamWriter to write to the specified stream using the default encoding.

Parameters:


OutputStreamWriter

public OutputStreamWriter(java.io.OutputStream out, java.lang.String encoding_scheme)

This method initializes a new instance of OutputStreamWriter to write to the specified stream using a caller supplied character encoding scheme. Note that due to a deficiency in the Java language design, there is no way to determine which encodings are supported.

Parameters:

Throws:


Method Details

close

public void close()

This method closes this stream, and the underlying OutputStream

Throws:


flush

public void flush()

This method flushes any buffered bytes to the underlying output sink.

Throws:


getEncoding

public String getEncoding()

This method returns the name of the character encoding scheme currently in use by this stream. If the stream has been closed, then this method may return null.

Returns:


write

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

This method writes len characters from the specified array to the output stream starting at position offset into the array.

Parameters:

Throws:


write

public void write(int c)

This method writes a single character to the output stream.

Parameters:

Throws:


write

public void write(java.lang.String str, int offset, int len)

This method writes len bytes from the specified String starting at position offset into the String.

Parameters:

Throws: