/* * Copyright (C) 2000 Ximian Inc. * * Authors: Michael Zucchi * * This program is free software; you can redistribute it and/or * modify it under the terms of version 2 of the GNU General Public * License as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public * License along with this program; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #ifndef _CAMEL_MIME_PARSER_H #define _CAMEL_MIME_PARSER_H #include #include #include #include #define CAMEL_MIME_PARSER(obj) CAMEL_CHECK_CAST (obj, camel_mime_parser_get_type (), CamelMimeParser) #define CAMEL_MIME_PARSER_CLASS(klass) CAMEL_CHECK_CLASS_CAST (klass, camel_mime_parser_get_type (), CamelMimeParserClass) #define CAMEL_IS_MIME_PARSER(obj) CAMEL_CHECK_TYPE (obj, camel_mime_parser_get_type ()) typedef struct _CamelMimeParserClass CamelMimeParserClass; /* NOTE: if you add more states, you may need to bump the start of the END tags to 16 or 32, etc - so they are the same as the matching start tag, with a bit difference */ enum _header_state { HSCAN_INITIAL, HSCAN_PRE_FROM, /* data before a 'From' line */ HSCAN_FROM, /* got 'From' line */ HSCAN_HEADER, /* toplevel header */ HSCAN_BODY, /* scanning body of message */ HSCAN_MULTIPART, /* got multipart header */ HSCAN_MESSAGE, /* rfc822 message */ HSCAN_PART, /* part of a multipart */ HSCAN_END = 8, /* bit mask for 'end' flags */ HSCAN_EOF = 8, /* end of file */ HSCAN_PRE_FROM_END, /* pre from end */ HSCAN_FROM_END, /* end of whole from bracket */ HSCAN_HEADER_END, /* dummy value */ HSCAN_BODY_END, /* end of message */ HSCAN_MULTIPART_END, /* end of multipart */ HSCAN_MESSAGE_END, /* end of message */ }; struct _CamelMimeParser { CamelObject parent; struct _CamelMimeParserPrivate *priv; }; struct _CamelMimeParserClass { CamelObjectClass parent_class; void (*message)(CamelMimeParser *, void *headers); void (*part)(CamelMimeParser *); void (*content)(CamelMimeParser *); }; guint camel_mime_parser_get_type (void); CamelMimeParser *camel_mime_parser_new (void); /* quick-fix for parser not erroring, we can find out if it had an error afterwards */ int camel_mime_parser_errno (CamelMimeParser *); /* using an fd will be a little faster, but not much (over a simple stream) */ int camel_mime_parser_init_with_fd(CamelMimeParser *, int fd); int camel_mime_parser_init_with_stream(CamelMimeParser *m, CamelStream *stream); /* get the stream or fd back of the parser */ CamelStream *camel_mime_parser_stream(CamelMimeParser *m); int camel_mime_parser_fd(CamelMimeParser *m); /* scan 'From' separators? */ void camel_mime_parser_scan_from(CamelMimeParser *, int); /* Do we want to know about the pre-from data? */ void camel_mime_parser_scan_pre_from(CamelMimeParser *, int); /* what headers to save, MUST include ^Content-Type: */ int camel_mime_parser_set_header_regex(CamelMimeParser *m, char *matchstr); /* normal interface */ enum _header_state camel_mime_parser_step(CamelMimeParser *, char **, int *); void camel_mime_parser_unstep(CamelMimeParser *); void camel_mime_parser_drop_step(CamelMimeParser *m); enum _header_state camel_mime_parser_state(CamelMimeParser *); /* read through the parser */ int camel_mime_parser_read(CamelMimeParser *m, const char **databuffer, int len); /* get content type for the current part/header */ struct _header_content_type *camel_mime_parser_content_type(CamelMimeParser *); /* get/change raw header by name */ const char *camel_mime_parser_header(CamelMimeParser *, const char *, int *offset); /* get all raw headers. READ ONLY! */ struct _header_raw *camel_mime_parser_headers_raw(CamelMimeParser *); /* get multipart pre/postface */ const char *camel_mime_parser_preface(CamelMimeParser *m); const char *camel_mime_parser_postface(CamelMimeParser *m); /* return the from line content */ const char *camel_mime_parser_from_line(CamelMimeParser *m); /* add a processing filter for body contents */ int camel_mime_parser_filter_add(CamelMimeParser *, CamelMimeFilter *); void camel_mime_parser_filter_remove(CamelMimeParser *, int); /* these should be used with caution, because the state will not track the seeked position */ /* FIXME: something to bootstrap the state? */ off_t camel_mime_parser_tell(CamelMimeParser *); off_t camel_mime_parser_seek(CamelMimeParser *, off_t, int); off_t camel_mime_parser_tell_start_headers(CamelMimeParser *); off_t camel_mime_parser_tell_start_from(CamelMimeParser *); #endif /* ! _CAMEL_MIME_PARSER_H */ d>
aboutsummaryrefslogtreecommitdiffstats
Commit message (Expand)AuthorAgeFilesLines