GMimeMessagePartial

GMimeMessagePartial — Partial MIME parts

Synopsis

                    GMimeMessagePartial;
GMimeMessagePartial* g_mime_message_partial_new         (const char *id,
                                                         int number,
                                                         int total);
const char*         g_mime_message_partial_get_id       (GMimeMessagePartial *partial);
int                 g_mime_message_partial_get_number   (GMimeMessagePartial *partial);
int                 g_mime_message_partial_get_total    (GMimeMessagePartial *partial);
GMimeMessage*       g_mime_message_partial_reconstruct_message
                                                        (GMimeMessagePartial **partials,
                                                         size_t num);
GMimeMessage**      g_mime_message_partial_split_message
                                                        (GMimeMessage *message,
                                                         size_t max_size,
                                                         size_t *nparts);

Object Hierarchy

  GObject
   +----GMimeObject
         +----GMimePart
               +----GMimeMessagePartial

Description

A GMimeMessagePartial represents the message/partial MIME part.

Details

GMimeMessagePartial

typedef struct _GMimeMessagePartial GMimeMessagePartial;

A message/partial MIME part.


g_mime_message_partial_new ()

GMimeMessagePartial* g_mime_message_partial_new         (const char *id,
                                                         int number,
                                                         int total);

Creates a new MIME message/partial object.

id :

message/partial part id

number :

message/partial part number

total :

total number of message/partial parts

Returns :

an empty MIME message/partial object.

g_mime_message_partial_get_id ()

const char*         g_mime_message_partial_get_id       (GMimeMessagePartial *partial);

Gets the message/partial id parameter value.

partial :

message/partial object

Returns :

the message/partial id or NULL on fail.

g_mime_message_partial_get_number ()

int                 g_mime_message_partial_get_number   (GMimeMessagePartial *partial);

Gets the message/partial part number.

partial :

message/partial object

Returns :

the message/partial part number or -1 on fail.

g_mime_message_partial_get_total ()

int                 g_mime_message_partial_get_total    (GMimeMessagePartial *partial);

Gets the total number of message/partial parts needed to reconstruct the original message.

partial :

message/partial object

Returns :

the total number of message/partial parts needed to reconstruct the original message or -1 on fail.

g_mime_message_partial_reconstruct_message ()

GMimeMessage*       g_mime_message_partial_reconstruct_message
                                                        (GMimeMessagePartial **partials,
                                                         size_t num);

Reconstructs the GMimeMessage from the given message/partial parts in partials.

partials :

an array of message/partial mime parts

num :

the number of elements in partials

Returns :

a GMimeMessage object on success or NULL on fail.

g_mime_message_partial_split_message ()

GMimeMessage**      g_mime_message_partial_split_message
                                                        (GMimeMessage *message,
                                                         size_t max_size,
                                                         size_t *nparts);

Splits message into an array of GMimeMessage objects each containing a single GMimeMessagePartial object containing max_size bytes or fewer. nparts is set to the number of GMimeMessagePartial objects created.

message :

message object

max_size :

max size

nparts :

number of parts

Returns :

an array of GMimeMessage objects and sets nparts to th number of messages returned or NULL on fail.