Top | ![]() |
![]() |
![]() |
![]() |
GMimeMessage * | g_mime_message_new () |
void | g_mime_message_set_sender () |
const char * | g_mime_message_get_sender () |
void | g_mime_message_set_reply_to () |
const char * | g_mime_message_get_reply_to () |
void | g_mime_message_add_recipient () |
InternetAddressList * | g_mime_message_get_recipients () |
InternetAddressList * | g_mime_message_get_all_recipients () |
void | g_mime_message_set_subject () |
const char * | g_mime_message_get_subject () |
void | g_mime_message_set_date () |
void | g_mime_message_get_date () |
void | g_mime_message_set_date_as_string () |
char * | g_mime_message_get_date_as_string () |
void | g_mime_message_set_message_id () |
const char * | g_mime_message_get_message_id () |
void | g_mime_message_set_mime_part () |
GMimeObject * | g_mime_message_get_mime_part () |
void | g_mime_message_foreach () |
GMimeObject * | g_mime_message_get_body () |
GMimeMessage *
g_mime_message_new (gboolean pretty_headers
);
If pretty_headers
is TRUE
, then the standard rfc822 headers are
initialized so as to put headers in a nice friendly order. This is
strictly a cosmetic thing, so if you are unsure, it is safe to say
no (FALSE
).
void g_mime_message_set_sender (GMimeMessage *message
,const char *sender
);
Set the sender's name and address on the MIME Message.
(ex: "\"Joe Sixpack\" <joesixpack.org
>")
Note: The sender
string should be the raw encoded email
address. It is probably best to use an InternetAddress to
construct and encode this value.
const char *
g_mime_message_get_sender (GMimeMessage *message
);
Gets the email address of the sender from message
.
void g_mime_message_set_reply_to (GMimeMessage *message
,const char *reply_to
);
Set the sender's Reply-To address on the message
.
Note: The reply_to
string should be the raw encoded email
address. It is probably best to use an InternetAddress to
construct and encode this value.
const char *
g_mime_message_get_reply_to (GMimeMessage *message
);
Gets the Reply-To address from message
.
void g_mime_message_add_recipient (GMimeMessage *message
,GMimeRecipientType type
,const char *name
,const char *addr
);
Add a recipient of a chosen type to the MIME message.
Note: The name
(and addr
) strings should be in UTF-8.
InternetAddressList * g_mime_message_get_recipients (GMimeMessage *message
,GMimeRecipientType type
);
Gets a list of recipients of the specified type
from the message
.
InternetAddressList *
g_mime_message_get_all_recipients (GMimeMessage *message
);
Gets the complete list of recipients for message
.
a newly allocated InternetAddressList
containing all recipients of the message or NULL
if no recipients
are set.
void g_mime_message_set_subject (GMimeMessage *message
,const char *subject
);
Set the subject of a message
.
Note: The subject
string should be in UTF-8.
const char *
g_mime_message_get_subject (GMimeMessage *message
);
Gets the subject of the message
.
void g_mime_message_set_date (GMimeMessage *message
,time_t date
,int tz_offset
);
Sets the Date header on a MIME Message.
void g_mime_message_get_date (GMimeMessage *message
,time_t *date
,int *tz_offset
);
Stores the date in time_t format in date
. If tz_offset
is
non-NULL
, then the timezone offset in will be stored in
tz_offset
.
void g_mime_message_set_date_as_string (GMimeMessage *message
,const char *str
);
Sets the sent-date of the message.
char *
g_mime_message_get_date_as_string (GMimeMessage *message
);
Gets the message's sent-date in string format.
void g_mime_message_set_message_id (GMimeMessage *message
,const char *message_id
);
Set the Message-Id on a message.
const char *
g_mime_message_get_message_id (GMimeMessage *message
);
Gets the Message-Id header of message
.
void g_mime_message_set_mime_part (GMimeMessage *message
,GMimeObject *mime_part
);
Set the root-level MIME part of the message.
GMimeObject *
g_mime_message_get_mime_part (GMimeMessage *message
);
Gets the toplevel MIME part contained within message
.
void g_mime_message_foreach (GMimeMessage *message
,GMimeObjectForeachFunc callback
,gpointer user_data
);
Recursively calls callback
on each of the mime parts in the mime message.
message |
||
callback |
function to call on each of the mime parts contained by the mime message. |
[scope call] |
user_data |
user-supplied callback data |
GMimeObject *
g_mime_message_get_body (GMimeMessage *message
);
Attempts to identify the MIME part containing the body of the message.
a GMimeObject containing the textual content that appears to be the main body of the message.
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.