gnu.mail.util
Class QOutputStream

java.lang.Object
  java.io.OutputStream
      java.io.FilterOutputStream
          gnu.mail.util.QPOutputStream
              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)