PopplerAttachment

PopplerAttachment — Attachments

Functions

Types and Values

Object Hierarchy

    GObject
    ╰── PopplerAttachment

Includes

#include <poppler.h>

Description

Functions

PopplerAttachmentSaveFunc ()

gboolean
(*PopplerAttachmentSaveFunc) (const gchar *buf,
                              gsize count,
                              gpointer data,
                              GError **error);

Specifies the type of the function passed to poppler_attachment_save_to_callback(). It is called once for each block of bytes that is "written" by poppler_attachment_save_to_callback(). If successful it should return TRUE. If an error occurs it should set error and return FALSE, in which case poppler_attachment_save_to_callback() will fail with the same error.

Parameters

buf

buffer containing bytes to be written.

[array length=count][element-type guint8]

count

number of bytes in buf .

 

data

user data passed to poppler_attachment_save_to_callback().

[closure]

error

GError to set on error, or NULL

 

Returns

TRUE if successful, FALSE (with error set) if failed.


poppler_attachment_save ()

gboolean
poppler_attachment_save (PopplerAttachment *attachment,
                         const char *filename,
                         GError **error);

Saves attachment to a file indicated by filename . If error is set, FALSE will be returned. Possible errors include those in the G_FILE_ERROR domain and whatever the save function generates.

Parameters

attachment

A PopplerAttachment.

 

filename

name of file to save

 

error

return location for error, or NULL.

[allow-none]

Returns

TRUE, if the file successfully saved


poppler_attachment_save_to_callback ()

gboolean
poppler_attachment_save_to_callback (PopplerAttachment *attachment,
                                     PopplerAttachmentSaveFunc save_func,
                                     gpointer user_data,
                                     GError **error);

Saves attachment by feeding the produced data to save_func . Can be used when you want to store the attachment to something other than a file, such as an in-memory buffer or a socket. If error is set, FALSE will be returned. Possible errors include those in the G_FILE_ERROR domain and whatever the save function generates.

Parameters

attachment

A PopplerAttachment.

 

save_func

a function that is called to save each block of data that the save routine generates.

[scope call]

user_data

user data to pass to the save function.

 

error

return location for error, or NULL.

[allow-none]

Returns

TRUE, if the save successfully completed

Types and Values

PopplerAttachment

typedef struct _PopplerAttachment PopplerAttachment;