Annotation of libwww/Library/src/HTMIME.html, revision 2.7

2.6       timbl       1: <HTML>
                      2: <HEAD>
2.7     ! timbl       3: <TITLE>HTMIME:   Parser of MIME format for libwww</TITLE>
2.6       timbl       4: <NEXTID N="z2">
                      5: </HEAD>
                      6: <BODY>
                      7: <H1>MIME Parser</H1>The MIME parser stream presents a
                      8: MIME document. It recursively invokes
                      9: the format manager to handle embedded
                     10: formats.<P>
                     11: As well as stripping off and parsing
                     12: the headers, the MIME parser has
                     13: to parse any weirld MIME encodings
                     14: it may meet within the body parts
                     15: of messages, and must deal with multipart
                     16: messages. <P>
                     17: This module is implemented to the
                     18: level necessary for operation with
                     19: WWW, but is not currently complete
                     20: for any arbitrary MIME message.<P>
                     21: Check the <A
                     22: NAME="z0" HREF="HTMIME.c">source</A> for latest additions
                     23: to functionality.<P>
                     24: The MIME parser is complicated by
                     25: the fact that WWW allows real binary
                     26: to be sent, not ASCII encoded.  Therefore
                     27: the netascii decoding is included
                     28: in this module. One cannot layer
                     29: it by converting first from Net to
                     30: local text, then decoding it. Of
                     31: course, for local files, the net
                     32: ascii decoding is not needed.  There
                     33: are therefore two creation routines.
                     34: <PRE>#ifndef HTMIME_H
2.1       timbl      35: #define HTMIME_H
                     36: 
                     37: #include "HTStream.h"
                     38: #include "HTAnchor.h"
                     39: 
2.6       timbl      40: </PRE>
                     41: <H3>Input: Local text</H3>
2.7     ! timbl      42: <PRE>/* extern HTStream * HTMIMEConvert PARAMS((HTRequest * request,
        !            43:                                        HTFormat input_format,
        !            44:                                        HTFormat output_format,
        !            45:                                        HTStream * output_stream));
        !            46: */
        !            47: extern HTConverter HTMIMEConvert;
        !            48: 
2.6       timbl      49: </PRE>
                     50: <H3>Input: Net ASCII</H3>
2.7     ! timbl      51: <PRE>/* extern HTStream * HTNetMIME PARAMS((HTRequest * request,
        !            52:                                        HTFormat input_format,
        !            53:                                        HTFormat output_format,
        !            54:                                        HTStream * output_stream));
        !            55: */
        !            56: extern HTConverter HTNetMIME;
2.1       timbl      57: 
                     58: 
                     59: #endif
                     60: 
2.7     ! timbl      61: </PRE>end of HTMIME</BODY>
2.6       timbl      62: </HTML>

Webmaster