|  |  |  | GMime 2.4 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
                    GMimeMultipart;
GMimeMultipart *    g_mime_multipart_new                (void);
GMimeMultipart *    g_mime_multipart_new_with_subtype   (const char *subtype);
void                g_mime_multipart_set_preface        (GMimeMultipart *multipart,
                                                         const char *preface);
const char *        g_mime_multipart_get_preface        (GMimeMultipart *multipart);
void                g_mime_multipart_set_postface       (GMimeMultipart *multipart,
                                                         const char *postface);
const char *        g_mime_multipart_get_postface       (GMimeMultipart *multipart);
void                g_mime_multipart_set_boundary       (GMimeMultipart *multipart,
                                                         const char *boundary);
const char *        g_mime_multipart_get_boundary       (GMimeMultipart *multipart);
void                g_mime_multipart_add                (GMimeMultipart *multipart,
                                                         GMimeObject *part);
void                g_mime_multipart_clear              (GMimeMultipart *multipart);
void                g_mime_multipart_insert             (GMimeMultipart *multipart,
                                                         int index,
                                                         GMimeObject *part);
gboolean            g_mime_multipart_remove             (GMimeMultipart *multipart,
                                                         GMimeObject *part);
GMimeObject *       g_mime_multipart_remove_at          (GMimeMultipart *multipart,
                                                         int index);
int                 g_mime_multipart_get_count          (GMimeMultipart *multipart);
gboolean            g_mime_multipart_contains           (GMimeMultipart *multipart,
                                                         GMimeObject *part);
int                 g_mime_multipart_index_of           (GMimeMultipart *multipart,
                                                         GMimeObject *part);
GMimeObject *       g_mime_multipart_get_part           (GMimeMultipart *multipart,
                                                         int index);
void                g_mime_multipart_foreach            (GMimeMultipart *multipart,
                                                         GMimeObjectForeachFunc callback,
                                                         gpointer user_data);
GMimeObject *       g_mime_multipart_get_subpart_from_content_id
                                                        (GMimeMultipart *multipart,
                                                         const char *content_id);
GObject +----GMimeObject +----GMimeMultipart +----GMimeMultipartEncrypted +----GMimeMultipartSigned
GMimeMultipart * g_mime_multipart_new (void);
Creates a new MIME multipart object with a default content-type of multipart/mixed.
| Returns : | an empty MIME multipart object with a default content-type of multipart/mixed. | 
GMimeMultipart * g_mime_multipart_new_with_subtype (const char *subtype);
Creates a new MIME multipart object with a content-type of
multipart/subtype.
| 
 | content-type subtype | 
| Returns : | an empty MIME multipart object with a content-type of
multipart/ subtype. | 
void g_mime_multipart_set_preface (GMimeMultipart *multipart, const char *preface);
Sets the preface on the multipart.
| 
 | a GMimeMultipart object | 
| 
 | preface | 
const char * g_mime_multipart_get_preface (GMimeMultipart *multipart);
Gets the preface on the multipart.
| 
 | a GMimeMultipart object | 
| Returns : | a pointer to the preface string on the multipart. | 
void g_mime_multipart_set_postface (GMimeMultipart *multipart, const char *postface);
Sets the postface on the multipart.
| 
 | a GMimeMultipart object | 
| 
 | postface | 
const char * g_mime_multipart_get_postface (GMimeMultipart *multipart);
Gets the postface on the multipart.
| 
 | a GMimeMultipart object | 
| Returns : | a pointer to the postface string on the multipart. | 
void g_mime_multipart_set_boundary (GMimeMultipart *multipart, const char *boundary);
Sets boundary as the boundary on the multipart. If boundary is
NULL, then a boundary will be auto-generated for you.
| 
 | a GMimeMultipart object | 
| 
 | boundary or NULLto autogenerate one | 
const char * g_mime_multipart_get_boundary (GMimeMultipart *multipart);
Gets the boundary on the multipart. If the internal boundary is
NULL, then an auto-generated boundary will be set on the multipart
and returned.
| 
 | a GMimeMultipart object | 
| Returns : | the boundary on the multipart. | 
void g_mime_multipart_add (GMimeMultipart *multipart, GMimeObject *part);
Adds a mime part to the multipart.
| 
 | a GMimeMultipart object | 
| 
 | a GMimeObject | 
void g_mime_multipart_clear (GMimeMultipart *multipart);
Removes all subparts from multipart.
| 
 | a GMimeMultipart object | 
void g_mime_multipart_insert (GMimeMultipart *multipart, int index, GMimeObject *part);
Inserts the specified mime part into the multipart at the position
index.
| 
 | a GMimeMultipart object | 
| 
 | position to insert the mime part | 
| 
 | mime part | 
gboolean g_mime_multipart_remove (GMimeMultipart *multipart, GMimeObject *part);
Removes the specified mime part from the multipart.
| 
 | a GMimeMultipart object | 
| 
 | mime part | 
| Returns : | TRUEif the part was removed orFALSEotherwise. | 
GMimeObject * g_mime_multipart_remove_at (GMimeMultipart *multipart, int index);
Removes the mime part at position index from the multipart.
| 
 | a GMimeMultipart object | 
| 
 | position of the mime part to remove | 
| Returns : | the mime part that was removed or NULLif the part was
not contained within the multipart. | 
int g_mime_multipart_get_count (GMimeMultipart *multipart);
Gets the number of mime parts contained within the multipart.
| 
 | a GMimeMultipart object | 
| Returns : | the number of mime parts contained within the multipart. | 
gboolean g_mime_multipart_contains (GMimeMultipart *multipart, GMimeObject *part);
Checks if part is contained within multipart.
| 
 | a GMimeMultipart object | 
| 
 | mime part | 
| Returns : | TRUEifpartis a subpart ofmultipartorFALSEotherwise. | 
int g_mime_multipart_index_of (GMimeMultipart *multipart, GMimeObject *part);
Gets the index of part within multipart.
| 
 | a GMimeMultipart object | 
| 
 | mime part | 
| Returns : | the index of partwithinmultipartor-1if not found. | 
GMimeObject * g_mime_multipart_get_part (GMimeMultipart *multipart, int index);
Gets the mime part at position index within the multipart.
| 
 | a GMimeMultipart object | 
| 
 | position of the mime part | 
| Returns : | the mime part at position index. | 
void g_mime_multipart_foreach (GMimeMultipart *multipart, GMimeObjectForeachFunc callback, gpointer user_data);
Recursively calls callback on each of multipart's subparts.
| 
 | a GMimeMultipart | 
| 
 | function to call for each of multipart's subparts. | 
| 
 | user-supplied callback data | 
GMimeObject * g_mime_multipart_get_subpart_from_content_id (GMimeMultipart *multipart, const char *content_id);
Gets the mime part with the content-id content_id from the
multipart multipart.
| 
 | a multipart | 
| 
 | the content id of the part to look for | 
| Returns : | the GMimeObject whose content-id matches the search string,
or NULLif a match cannot be found. |