gnu.mail.util
Class QOutputStream

java.lang.Object
  extended by java.io.OutputStream
      extended by java.io.FilterOutputStream
          extended by gnu.mail.util.QPOutputStream
              extended by gnu.mail.util.QOutputStream
All Implemented Interfaces:
java.io.Closeable, java.io.Flushable

public class QOutputStream
extends QPOutputStream

Provides RFC 2047 "B" transfer decoding. See section 4.2:

The "Q" encoding is similar to the "Quoted-Printable" content- transfer-encoding defined in RFC 2045. It is designed to allow text containing mostly ASCII characters to be decipherable on an ASCII terminal without decoding.

  1. Any 8-bit value may be represented by a "=" followed by two hexadecimal digits. For example, if the character set in use were ISO-8859-1, the "=" character would thus be encoded as "=3D", and a SPACE by "=20". (Upper case should be used for hexadecimal digits "A" through "F".)
  2. The 8-bit hexadecimal value 20(e.g., ISO-8859-1 SPACE) may be represented as "_"(underscore, ASCII 95.). (This character may not pass through some internetwork mail gateways, but its use will greatly enhance readability of "Q" encoded data with mail readers that do not support this encoding.) Note that the "_" always represents hexadecimal 20, even if the SPACE character occupies a different code position in the character set in use.
  3. 8-bit values which correspond to printable ASCII characters other than "=", "?", and "_"(underscore), MAY be represented as those characters. (But see section 5 for restrictions.) In particular, SPACE and TAB MUST NOT be represented as themselves within encoded words.


    Field Summary
     
    Fields inherited from class java.io.FilterOutputStream
    out
     
    Constructor Summary
    QOutputStream(java.io.OutputStream out, boolean word)
              Constructor.
     
    Method Summary
    static int encodedLength(byte[] bytes, boolean word)
               
     void write(int c)
              Write a character to the stream.
     
    Methods inherited from class gnu.mail.util.QPOutputStream
    close, flush, output, write, write
     
    Methods inherited from class java.lang.Object
    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
     

    Constructor Detail

    QOutputStream

    public QOutputStream(java.io.OutputStream out,
                         boolean word)
    Constructor. The word parameter is used to indicate whether the bytes passed to this stream are considered to be RFC 822 "word" tokens or "text" tokens.

    Parameters:
    out - the underlying output stream
    word - word mode if true, text mode otherwise
    Method Detail

    write

    public void write(int c)
               throws java.io.IOException
    Write a character to the stream.

    Overrides:
    write in class QPOutputStream
    Parameters:
    c - Byte to write to the stream
    Throws:
    java.io.IOException - IO Exception occurred

    encodedLength

    public static int encodedLength(byte[] bytes,
                                    boolean word)