FileDocCategorySizeDatePackage
WriterToASCI.javaAPI DocJava SE 5 API3797Fri Aug 26 14:56:04 BST 2005com.sun.org.apache.xml.internal.serializer

WriterToASCI

public class WriterToASCI extends Writer
This class writes ASCII to a byte stream as quickly as possible. For the moment it does not do buffering, though I reserve the right to do some buffering down the line if I can prove that it will be faster even if the output stream is buffered.

Fields Summary
private final OutputStream
m_os
The byte stream to write to.
Constructors Summary
public WriterToASCI(OutputStream os)
Create an unbuffered ASCII writer.

param
os The byte stream to write to.

    m_os = os;
  
Methods Summary
public voidclose()
Close the stream, flushing it first. Once a stream has been closed, further write() or flush() invocations will cause an IOException to be thrown. Closing a previously-closed stream, however, has no effect.

exception
IOException If an I/O error occurs

    m_os.close();
  
public voidflush()
Flush the stream. If the stream has saved any characters from the various write() methods in a buffer, write them immediately to their intended destination. Then, if that destination is another character or byte stream, flush it. Thus one flush() invocation will flush all the buffers in a chain of Writers and OutputStreams.

exception
IOException If an I/O error occurs

    m_os.flush();
  
public java.io.OutputStreamgetOutputStream()
Get the output stream where the events will be serialized to.

return
reference to the result stream, or null of only a writer was set.

    return m_os;
  
public voidwrite(char[] chars, int start, int length)
Write a portion of an array of characters.

param
chars Array of characters
param
start Offset from which to start writing characters
param
length Number of characters to write
exception
IOException If an I/O error occurs
throws
java.io.IOException


    int n = length+start;

    for (int i = start; i < n; i++)
    {
      m_os.write(chars[i]);
    }
  
public voidwrite(int c)
Write a single character. The character to be written is contained in the 16 low-order bits of the given integer value; the 16 high-order bits are ignored.

Subclasses that intend to support efficient single-character output should override this method.

param
c int specifying a character to be written.
exception
IOException If an I/O error occurs

    m_os.write(c);
  
public voidwrite(java.lang.String s)
Write a string.

param
str String to be written
exception
IOException If an I/O error occurs

    int n = s.length();
    for (int i = 0; i < n; i++)
    {
      m_os.write(s.charAt(i));
    }