| Poppler Reference Manual | ||||
|---|---|---|---|---|
PopplerAttachment;
gboolean poppler_attachment_save (PopplerAttachment *attachment,
const char *filename,
GError **error);
gboolean poppler_attachment_save_to_callback (PopplerAttachment *attachment,
PopplerAttachmentSaveFunc save_func,
gpointer user_data,
GError **error);
gboolean (*PopplerAttachmentSaveFunc) (const gchar *buf,
gsize count,
gpointer data,
GError **error);
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.
| attachment : | A PopplerAttachment. |
| filename : | name of file to save |
| error : | return location for error, or NULL. |
| Returns : | TRUE, if the file successfully saved |
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.
| attachment : | A GdkPixbuf. |
| save_func : | a function that is called to save each block of data that the save routine generates. |
| user_data : | user data to pass to the save function. |
| error : | return location for error, or NULL. |
| Returns : | TRUE, if the save successfully completed |
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.
| buf : | buffer containing bytes to be written. |
| count : | number of bytes in buf. |
| data : | A location to return an error. |
| error : | user data passed to poppler_attachment_save_to_callback() |
| Returns : | TRUE if successful, FALSE (with error set) if failed. |