enum GMimePartEncodingType

typedef enum {
	GMIME_PART_ENCODING_DEFAULT,
	GMIME_PART_ENCODING_7BIT,
	GMIME_PART_ENCODING_8BIT,
	GMIME_PART_ENCODING_BINARY,
	GMIME_PART_ENCODING_BASE64,
	GMIME_PART_ENCODING_QUOTEDPRINTABLE,
	GMIME_PART_ENCODING_UUENCODE,
	GMIME_PART_NUM_ENCODINGS
} GMimePartEncodingType;

A Content-Transfer-Encoding type.

GMimeReferences

typedef struct {
	GMimeReferences *next;
	char *msgid;
} GMimeReferences;

A List of references, as per the References or In-Reply-To header fields.

g_mime_utils_header_decode_date ()

time_t              g_mime_utils_header_decode_date     (const char *in,
                                                         int *tz_offset);

Decodes the rfc822 date string and saves the GMT offset into tz_offset if non-NULL.

g_mime_utils_header_format_date ()

char *              g_mime_utils_header_format_date     (time_t date,
                                                         int tz_offset);

Allocates a string buffer containing the rfc822 formatted date string represented by time and tz_offset.

g_mime_utils_generate_message_id ()

char *              g_mime_utils_generate_message_id    (const char *fqdn);

Generates a unique Message-Id.

g_mime_utils_decode_message_id ()

char *              g_mime_utils_decode_message_id      (const char *message_id);

Decodes a msg-id as defined by rfc822.

g_mime_references_decode ()

GMimeReferences *   g_mime_references_decode            (const char *text);

Decodes a list of msg-ids as in the References and/or In-Reply-To headers defined in rfc822.

g_mime_references_append ()

void                g_mime_references_append            (GMimeReferences **refs,
                                                         const char *msgid);

Appends a reference to msgid to the list of references.

g_mime_references_clear ()

void                g_mime_references_clear             (GMimeReferences **refs);

Clears the GMimeReferences list and resets it to NULL.

g_mime_references_next ()

GMimeReferences *   g_mime_references_next              (const GMimeReferences *ref);

Advances to the next reference node in the GMimeReferences list.

g_mime_utils_header_fold ()

char *              g_mime_utils_header_fold            (const char *in);

Folds a structured header according to the rules in rfc822.

g_mime_utils_header_printf ()

char *              g_mime_utils_header_printf          (const char *format,
                                                         ...);

Allocates a buffer containing a formatted header specified by the Varargs.

g_mime_utils_quote_string ()

char *              g_mime_utils_quote_string           (const char *string);

Quotes string as needed according to the rules in rfc2045.

g_mime_utils_unquote_string ()

void                g_mime_utils_unquote_string         (char *string);

Unquotes and unescapes a string.

g_mime_utils_text_is_8bit ()

gboolean            g_mime_utils_text_is_8bit           (unsigned char *text,
                                                         size_t len);

Determines if text contains 8bit characters within the first len bytes.

g_mime_utils_best_encoding ()

GMimePartEncodingType  g_mime_utils_best_encoding       (unsigned char *text,
                                                         size_t len);

Determines the best content encoding for the first len bytes of text.

g_mime_utils_decode_8bit ()

char *              g_mime_utils_decode_8bit            (const char *text,
                                                         size_t len);

Attempts to convert text in an unknown 8bit/multibyte charset into UTF-8 by finding the charset which will convert the most bytes into valid UTF-8 characters as possible. If no exact match can be found, it will choose the best match and convert invalid byte sequences into question-marks (?) in the returned string buffer.

g_mime_utils_header_decode_text ()

char *              g_mime_utils_header_decode_text     (const char *in);

Decodes an rfc2047 encoded 'text' header.

Note: See g_mime_set_user_charsets() for details on how charset conversion is handled for unencoded 8bit text and/or wrongly specified rfc2047 encoded-word tokens.

g_mime_utils_header_encode_text ()

char *              g_mime_utils_header_encode_text     (const char *in);

Encodes a 'text' header according to the rules in rfc2047.

g_mime_utils_header_decode_phrase ()

char *              g_mime_utils_header_decode_phrase   (const char *in);

Decodes an rfc2047 encoded 'phrase' header.

Note: See g_mime_set_user_charsets() for details on how charset conversion is handled for unencoded 8bit text and/or wrongly specified rfc2047 encoded-word tokens.

g_mime_utils_header_encode_phrase ()

char *              g_mime_utils_header_encode_phrase   (const char *in);

Encodes a 'phrase' header according to the rules in rfc2047.

g_mime_utils_8bit_header_decode ()

char *              g_mime_utils_8bit_header_decode     (unsigned char *in);

Decodes an rfc2047 encoded header.

WARNING: This function is deprecated. Use g_mime_utils_header_decode_text() instead.

g_mime_utils_8bit_header_encode ()

char *              g_mime_utils_8bit_header_encode     (unsigned char *in);

Encodes a 'text' header according to the rules in rfc2047.

WARNING: This function is deprecated. Use g_mime_utils_header_encode_text() instead.

g_mime_utils_8bit_header_encode_phrase ()

char *              g_mime_utils_8bit_header_encode_phrase
                                                        (unsigned char *in);

Encodes a 'phrase' header according to the rules in rfc2047.

WARNING: This function is deprecated. Use g_mime_utils_header_encode_phrase() instead.

g_mime_utils_structured_header_fold ()

char *              g_mime_utils_structured_header_fold (const char *in);

Folds a structured header according to the rules in rfc822.

g_mime_utils_unstructured_header_fold ()

char *              g_mime_utils_unstructured_header_fold
                                                        (const char *in);

Folds an unstructured header according to the rules in rfc822.

GMIME_BASE64_ENCODE_LEN()

#define GMIME_BASE64_ENCODE_LEN(x) ((size_t) (((((x) + 2) / 57) * 77) + 77))

Calculates the maximum number of bytes needed to base64 encode the full input buffer of length x.

g_mime_utils_base64_decode_step ()

size_t              g_mime_utils_base64_decode_step     (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Decodes a chunk of base64 encoded data.

g_mime_utils_base64_encode_step ()

size_t              g_mime_utils_base64_encode_step     (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Base64 encodes a chunk of data. Performs an 'encode step', only encodes blocks of 3 characters to the output at a time, saves left-over state in state and save (initialise to 0 on first invocation).

g_mime_utils_base64_encode_close ()

size_t              g_mime_utils_base64_encode_close    (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Base64 encodes the input stream to the output stream. Call this when finished encoding data with g_mime_utils_base64_encode_step() to flush off the last little bit.

GMIME_UUDECODE_STATE_INIT

#define GMIME_UUDECODE_STATE_INIT   (0)

Initial state for the g_mime_utils_uudecode_step() function.

GMIME_UUDECODE_STATE_BEGIN

#define GMIME_UUDECODE_STATE_BEGIN  (1 << 16)

State for the g_mime_utils_uudecode_step() function, denoting that the 'begin' line has been found.

GMIME_UUDECODE_STATE_END

#define GMIME_UUDECODE_STATE_END    (1 << 17)

State for the g_mime_utils_uudecode_step() function, denoting that the end of the UU encoded block has been found.

GMIME_UUENCODE_LEN()

#define GMIME_UUENCODE_LEN(x)      ((size_t) (((((x) + 2) / 45) * 62) + 64))

Calculates the maximum number of bytes needed to uuencode the full input buffer of length x.

g_mime_utils_uudecode_step ()

size_t              g_mime_utils_uudecode_step          (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Uudecodes a chunk of data. Performs a 'decode step' on a chunk of uuencoded data. Assumes the "begin mode filename" line has been stripped off.

g_mime_utils_uuencode_step ()

size_t              g_mime_utils_uuencode_step          (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         unsigned char *uubuf,
                                                         int *state,
                                                         guint32 *save);

Uuencodes a chunk of data. Performs an 'encode step', only encodes blocks of 45 characters to the output at a time, saves left-over state in uubuf, state and save (initialize to 0 on first invocation).

g_mime_utils_uuencode_close ()

size_t              g_mime_utils_uuencode_close         (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         unsigned char *uubuf,
                                                         int *state,
                                                         guint32 *save);

Uuencodes a chunk of data. Call this when finished encoding data with g_mime_utils_uuencode_step() to flush off the last little bit.

GMIME_QP_ENCODE_LEN()

#define GMIME_QP_ENCODE_LEN(x)     ((size_t) ((((x) / 24) * 74) + 74))

Calculates the maximum number of bytes needed to encode the full input buffer of length x using the quoted-printable encoding.

g_mime_utils_quoted_decode_step ()

size_t              g_mime_utils_quoted_decode_step     (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Decodes a block of quoted-printable encoded data. Performs a 'decode step' on a chunk of QP encoded data.

g_mime_utils_quoted_encode_step ()

size_t              g_mime_utils_quoted_encode_step     (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Quoted-printable encodes a block of text. Performs an 'encode step', saves left-over state in state and save (initialise to -1 on first invocation).

g_mime_utils_quoted_encode_close ()

size_t              g_mime_utils_quoted_encode_close    (unsigned char *in,
                                                         size_t inlen,
                                                         unsigned char *out,
                                                         int *state,
                                                         guint32 *save);

Quoted-printable encodes a block of text. Call this when finished encoding data with g_mime_utils_quoted_encode_step() to flush off the last little bit.