gmime-message

Name

gmime-message -- 

Synopsis



#define     GMIME_RECIPIENT_TYPE_TO
#define     GMIME_RECIPIENT_TYPE_CC
#define     GMIME_RECIPIENT_TYPE_BCC
struct      GMimeHeader;
struct      GMimeMessageHeader;
struct      GMimeMessage;
GMimeMessage* g_mime_message_new            (void);
void        g_mime_message_destroy          (GMimeMessage *message);
void        g_mime_message_set_sender       (GMimeMessage *message,
                                             const gchar *sender);
const gchar* g_mime_message_get_sender      (GMimeMessage *message);
void        g_mime_message_set_reply_to     (GMimeMessage *message,
                                             const gchar *reply_to);
const gchar* g_mime_message_get_reply_to    (GMimeMessage *message);
void        g_mime_message_add_recipient    (GMimeMessage *message,
                                             gchar *type,
                                             const gchar *name,
                                             const gchar *address);
void        g_mime_message_add_recipients_from_string
                                            (GMimeMessage *message,
                                             gchar *type,
                                             const gchar *string);
GList*      g_mime_message_get_recipients   (GMimeMessage *message,
                                             const gchar *type);
void        g_mime_message_set_subject      (GMimeMessage *message,
                                             const gchar *subject);
const gchar* g_mime_message_get_subject     (GMimeMessage *message);
void        g_mime_message_set_date         (GMimeMessage *message,
                                             time_t date,
                                             int gmt_offset);
void        g_mime_message_get_date         (GMimeMessage *message,
                                             time_t *date,
                                             int *gmt_offset);
gchar*      g_mime_message_get_date_string  (GMimeMessage *message);
void        g_mime_message_set_message_id   (GMimeMessage *message,
                                             const gchar *id);
const gchar* g_mime_message_get_message_id  (GMimeMessage *message);
void        g_mime_message_set_header       (GMimeMessage *message,
                                             const gchar *field,
                                             const gchar *value);
const gchar* g_mime_message_get_header      (GMimeMessage *message,
                                             const gchar *field);
void        g_mime_message_set_mime_part    (GMimeMessage *message,
                                             GMimePart *mime_part);
void        g_mime_message_write_to_string  (GMimeMessage *message,
                                             GString *string);
gchar*      g_mime_message_to_string        (GMimeMessage *message);
gchar*      g_mime_message_get_body         (const GMimeMessage *message,
                                             gboolean want_plain,
                                             gboolean *is_html);
gchar*      g_mime_message_get_headers      (GMimeMessage *message);
void        g_mime_message_foreach_part     (GMimeMessage *message,
                                             GMimePartFunc callback,
                                             gpointer data);

Description

Details

GMIME_RECIPIENT_TYPE_TO

#define	GMIME_RECIPIENT_TYPE_TO  "To"


GMIME_RECIPIENT_TYPE_CC

#define	GMIME_RECIPIENT_TYPE_CC  "Cc"


GMIME_RECIPIENT_TYPE_BCC

#define	GMIME_RECIPIENT_TYPE_BCC "Bcc"


struct GMimeHeader

struct GMimeHeader;


struct GMimeMessageHeader

struct GMimeMessageHeader {
	gchar *from;
	gchar *reply_to;
	
	GHashTable *recipients;
	
	gchar *subject;
	
	time_t date;
	int gmt_offset;     /* GMT offset */
	
	gchar *message_id;
	
	GMimeHeader *headers;
};


struct GMimeMessage

struct GMimeMessage {
	GMimeMessageHeader *header;
	
	GMimePart *mime_part;
};


g_mime_message_new ()

GMimeMessage* g_mime_message_new            (void);

Returns :an empty MIME Message object with no headers nor content set by default.


g_mime_message_destroy ()

void        g_mime_message_destroy          (GMimeMessage *message);

Releases all memory used by the MIME Message and it's child MIME Parts back to the Operating System for reuse.

message : MIME Message to destroy


g_mime_message_set_sender ()

void        g_mime_message_set_sender       (GMimeMessage *message,
                                             const gchar *sender);

Set the sender's name and address on the MIME Message. (ex: "\"Joe Sixpack\" <joesixpack.org>")

message : MIME Message to change
sender : The name and address of the sender


g_mime_message_get_sender ()

const gchar* g_mime_message_get_sender      (GMimeMessage *message);

message : MIME Message
Returns :the sender's name and address of the MIME Message.


g_mime_message_set_reply_to ()

void        g_mime_message_set_reply_to     (GMimeMessage *message,
                                             const gchar *reply_to);

Set the sender's Reply-To address on the MIME Message.

message : MIME Message to change
reply_to : The Reply-To address


g_mime_message_get_reply_to ()

const gchar* g_mime_message_get_reply_to    (GMimeMessage *message);

message : MIME Message
Returns :the sender's Reply-To address from the MIME Message.


g_mime_message_add_recipient ()

void        g_mime_message_add_recipient    (GMimeMessage *message,
                                             gchar *type,
                                             const gchar *name,
                                             const gchar *address);

Add a recipient of a chosen type to the MIME Message. Available recipient types include: GMIME_RECIPIENT_TYPE_TO, GMIME_RECIPIENT_TYPE_CC and GMIME_RECIPIENT_TYPE_BCC.

message : MIME Message to change
type : Recipient type
name : The recipient's name
address : The recipient's address


g_mime_message_add_recipients_from_string ()

void        g_mime_message_add_recipients_from_string
                                            (GMimeMessage *message,
                                             gchar *type,
                                             const gchar *string);

Add a list of recipients of a chosen type to the MIME Message. Available recipient types include: GMIME_RECIPIENT_TYPE_TO, GMIME_RECIPIENT_TYPE_CC and GMIME_RECIPIENT_TYPE_BCC. The string must be in the format specified in rfc822.

message : MIME Message
type : Recipient type
string : A string of recipient names and addresses.


g_mime_message_get_recipients ()

GList*      g_mime_message_get_recipients   (GMimeMessage *message,
                                             const gchar *type);

message : MIME Message
type : Recipient type
Returns :a list of recipients of a chosen type from the MIME Message. Available recipient types include: GMIME_RECIPIENT_TYPE_TO, GMIME_RECIPIENT_TYPE_CC and GMIME_RECIPIENT_TYPE_BCC.


g_mime_message_set_subject ()

void        g_mime_message_set_subject      (GMimeMessage *message,
                                             const gchar *subject);

Set the Subject field on a MIME Message.

message : MIME Message
subject : Subject string


g_mime_message_get_subject ()

const gchar* g_mime_message_get_subject     (GMimeMessage *message);

message : MIME Message
Returns :the Subject field on a MIME Message.


g_mime_message_set_date ()

void        g_mime_message_set_date         (GMimeMessage *message,
                                             time_t date,
                                             int gmt_offset);

Set the sent-date on a MIME Message.

message : MIME Message
date : Sent-date (ex: gotten from time (NULL);)
gmt_offset : GMT date offset (in +/- hours)


g_mime_message_get_date ()

void        g_mime_message_get_date         (GMimeMessage *message,
                                             time_t *date,
                                             int *gmt_offset);

Stores the date in time_t format in date and the GMT offset in gmt_offset.

message : MIME Message
date : Sent-date
gmt_offset : GMT date offset (in +/- hours)


g_mime_message_get_date_string ()

gchar*      g_mime_message_get_date_string  (GMimeMessage *message);

message : MIME Message
Returns :the sent-date of the MIME Message in string format.


g_mime_message_set_message_id ()

void        g_mime_message_set_message_id   (GMimeMessage *message,
                                             const gchar *id);

Set the Message-Id on a message.

message : MIME Message
id : message-id


g_mime_message_get_message_id ()

const gchar* g_mime_message_get_message_id  (GMimeMessage *message);

message : MIME Message
Returns :the Message-Id of a message.


g_mime_message_set_header ()

void        g_mime_message_set_header       (GMimeMessage *message,
                                             const gchar *field,
                                             const gchar *value);

Add an arbitrary message header to the MIME Message such as X-Mailer, X-Priority, or In-Reply-To.

message : MIME Message
field : rfc822 header field
value : the contents of the header field


g_mime_message_get_header ()

const gchar* g_mime_message_get_header      (GMimeMessage *message,
                                             const gchar *field);

message : MIME Message
field : rfc822 header field
Returns :the value of the requested header (or NULL if it isn't set)


g_mime_message_set_mime_part ()

void        g_mime_message_set_mime_part    (GMimeMessage *message,
                                             GMimePart *mime_part);

Set the root-level MIME part of the message.

message : MIME Message
mime_part : The root-level MIME Part


g_mime_message_write_to_string ()

void        g_mime_message_write_to_string  (GMimeMessage *message,
                                             GString *string);

Write the contents of the MIME Message to string.

message : MIME Message
string : output string


g_mime_message_to_string ()

gchar*      g_mime_message_to_string        (GMimeMessage *message);

message : MIME Message
Returns :an allocated string containing the MIME Message.


g_mime_message_get_body ()

gchar*      g_mime_message_get_body         (const GMimeMessage *message,
                                             gboolean want_plain,
                                             gboolean *is_html);

message : MIME Message
want_plain : request text/plain
is_html : body returned is in html format
Returns :the prefered form of the message body. Sets the value of is_html to TRUE if the part returned is in HTML format, otherwise FALSE. Note: This function is NOT guarenteed to always work as it makes some assumptions that are not necessarily true. It is recommended that you traverse the MIME structure yourself.


g_mime_message_get_headers ()

gchar*      g_mime_message_get_headers      (GMimeMessage *message);

message : MIME Message
Returns :an allocated string containing the raw message headers.


g_mime_message_foreach_part ()

void        g_mime_message_foreach_part     (GMimeMessage *message,
                                             GMimePartFunc callback,
                                             gpointer data);

Calls callback on each of the mime parts in the mime message.

message : MIME message
callback : function to call on each of the mime parts contained by the mime message
data : extra data to pass to the callback