86 lines
3.7 KiB
C
86 lines
3.7 KiB
C
|
#ifndef ZOIDBERG_GARGOYLE_MAIL_UTIL_H
|
||
|
|
#define ZOIDBERG_GARGOYLE_MAIL_UTIL_H
|
||
|
|
/* mail util - header parsing
|
||
|
|
**
|
||
|
|
** Copyright 2001-2003 Dr. Zoidberg Enterprises. All rights reserved.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#include <stdio.h>
|
||
|
|
|
||
|
|
class BString;
|
||
|
|
|
||
|
|
// The next couple of functions are our wrapper around convert_to_utf8 and
|
||
|
|
// convert_from_utf8 so that they can also convert from UTF-8 to UTF-8 by
|
||
|
|
// specifying the MDR_UTF8_CONVERSION constant as the conversion operation.
|
||
|
|
|
||
|
|
status_t mail_convert_to_utf8(uint32 srcEncoding, const char *src,
|
||
|
|
int32 *srcLen, char *dst, int32 *dstLen, int32 *state,
|
||
|
|
char substitute = B_SUBSTITUTE);
|
||
|
|
|
||
|
|
status_t mail_convert_from_utf8(uint32 dstEncoding, const char *src,
|
||
|
|
int32 *srcLen, char *dst, int32 *dstLen, int32 *state,
|
||
|
|
char substitute = B_SUBSTITUTE);
|
||
|
|
|
||
|
|
|
||
|
|
void trim_white_space(BString &string);
|
||
|
|
// Remove leading and trailing white space from the string.
|
||
|
|
|
||
|
|
void SubjectToThread(BString &string);
|
||
|
|
// Convert a subject to the core words (remove the extraneous RE: re: etc).
|
||
|
|
|
||
|
|
time_t ParseDateWithTimeZone(const char *DateString);
|
||
|
|
// Converts a date to a time. Handles time zones too, unlike parsedate.
|
||
|
|
|
||
|
|
ssize_t rfc2047_to_utf8(char **buffer, size_t *bufLen, size_t strLen = 0);
|
||
|
|
ssize_t utf8_to_rfc2047(char **bufp, ssize_t length,uint32 charset, char encoding);
|
||
|
|
// convert (in place) RFC 2047-style escape sequences ("=?...?.?...?=")
|
||
|
|
// in the first strLen characters of *buffer into UTF-8, and return the
|
||
|
|
// length of the converted string or an error code less than 0 on error.
|
||
|
|
//
|
||
|
|
// This may cause the string to grow. If it grows bigger than *bufLen,
|
||
|
|
// *buffer will be reallocated using realloc(), and its new length stored
|
||
|
|
// in *bufLen.
|
||
|
|
//
|
||
|
|
// Unidentified charsets and conversion errors cause
|
||
|
|
// the offending text to be skipped.
|
||
|
|
|
||
|
|
void FoldLineAtWhiteSpaceAndAddCRLF (BString &string);
|
||
|
|
// Insert CRLF at various spots in the given string (before white space) so
|
||
|
|
// that the line length is mostly under 78 bytes. Also makes sure there is a
|
||
|
|
// CRLF at the very end.
|
||
|
|
|
||
|
|
ssize_t nextfoldedline(const char** header, char **buffer, size_t *buflen);
|
||
|
|
ssize_t readfoldedline(FILE *file, char **buffer, size_t *buflen);
|
||
|
|
ssize_t readfoldedline(BPositionIO &in, char **buffer, size_t *buflen);
|
||
|
|
// Return in *buffer a \n-terminated line (even if the original is \r\n
|
||
|
|
// terminated or not terminated at all (last line in file situation)) from a
|
||
|
|
// memory buffer, FILE* or BPositionIO, after folding \r?\n(\s)->$1. Return
|
||
|
|
// the length of the folded string directly, or a negative error code if there
|
||
|
|
// was a memory allocation error or file read error. It will return zero only
|
||
|
|
// when trying to read at end of file. *header, *file and &in are left
|
||
|
|
// pointing to the first character after the line read.
|
||
|
|
//
|
||
|
|
// if buffer is not NULL return a pointer to the buffer in *buffer
|
||
|
|
// if *buffer is not NULL, use the preallocated buffer, though it may get
|
||
|
|
// realloc'd (so use malloc to allocate it and expect to have your *buffer
|
||
|
|
// pointer modified to point to the new buffer if a realloc happens).
|
||
|
|
// if buflen is not NULL, return the final size of the buffer in buflen
|
||
|
|
// if buffer is not NULL, buflen is not NULL, and *buffer is not NULL
|
||
|
|
// *buffer is a buffer of size *buflen
|
||
|
|
// if buffer is NULL or *buffer is NULL, and buflen is not NULL then
|
||
|
|
// start with a buffer of size *buflen
|
||
|
|
|
||
|
|
status_t parse_header(BMessage &headers, BPositionIO &input);
|
||
|
|
|
||
|
|
void extract_address(BString &address);
|
||
|
|
// retrieves the mail address only from an address header formatted field
|
||
|
|
|
||
|
|
void extract_address_name(BString &address);
|
||
|
|
// Given a header field (usually the From: e-mail address) with gobbledygook in
|
||
|
|
// it, find the longest human-readable phrase (usually the person's name).
|
||
|
|
|
||
|
|
void get_address_list(BList &list, const char *string, void (*cleanupFunc)(BString &) = NULL);
|
||
|
|
|
||
|
|
#endif /* ZOIDBERG_GARGOYLE_MAIL_UTIL_H */
|