Mercurial > dovecot > original-hg > dovecot-1.2
view src/lib-mail/rfc822-parser.h @ 6115:35d12c0cd7a7 HEAD
Added comments
author | Timo Sirainen <tss@iki.fi> |
---|---|
date | Fri, 20 Jul 2007 08:31:06 +0300 |
parents | e64f8694b3f3 |
children | 9214044ce1f1 |
line wrap: on
line source
#ifndef __RFC822_PARSER_H #define __RFC822_PARSER_H struct rfc822_parser_context { const unsigned char *data, *end; string_t *last_comment; }; /* Parse given data using RFC 822 token parser. */ void rfc822_parser_init(struct rfc822_parser_context *ctx, const unsigned char *data, size_t size, string_t *last_comment); /* The functions below return 1 = more data available, 0 = no more data available (but a value might have been returned now), -1 = invalid input. LWSP is automatically skipped after value, but not before it. So typically you begin with skipping LWSP and then start using the parse functions. */ /* Parse comment. Assumes parser's data points to '(' */ int rfc822_skip_comment(struct rfc822_parser_context *ctx); /* Skip LWSP if there is any */ int rfc822_skip_lwsp(struct rfc822_parser_context *ctx); /* Stop at next non-atext char */ int rfc822_parse_atom(struct rfc822_parser_context *ctx, string_t *str); /* Like parse_atom() but don't stop at '.' */ int rfc822_parse_dot_atom(struct rfc822_parser_context *ctx, string_t *str); /* Like parse_dot_atom() but stops for '/', '?' and '='. Also it doesn't allow LWSP around '.' chars. */ int rfc822_parse_mime_token(struct rfc822_parser_context *ctx, string_t *str); /* "quoted string" */ int rfc822_parse_quoted_string(struct rfc822_parser_context *ctx, string_t *str); /* atom or quoted-string */ int rfc822_parse_phrase(struct rfc822_parser_context *ctx, string_t *str); /* dot-atom / domain-literal */ int rfc822_parse_domain(struct rfc822_parser_context *ctx, string_t *str); #endif