CamelDataWrapper: Camel Reference Manual

## CamelDataWrapper CamelDataWrapper |

## Functions

CamelDataWrapper * | camel_data_wrapper_new ()
GByteArray * | camel_data_wrapper_get_byte_array ()
CamelTransferEncoding | camel_data_wrapper_get_encoding ()
void | camel_data_wrapper_set_encoding ()
void | camel_data_wrapper_set_mime_type ()
gchar * | camel_data_wrapper_get_mime_type ()
CamelContentType * | camel_data_wrapper_get_mime_type_field ()
void | camel_data_wrapper_set_mime_type_field ()
void | camel_data_wrapper_take_mime_type_field ()
gboolean | camel_data_wrapper_is_offline ()
void | camel_data_wrapper_set_offline ()
gssize | camel_data_wrapper_write_to_stream_sync ()
void | camel_data_wrapper_write_to_stream ()
gssize | camel_data_wrapper_write_to_stream_finish ()
gssize | camel_data_wrapper_decode_to_stream_sync ()
void | camel_data_wrapper_decode_to_stream ()
gssize | camel_data_wrapper_decode_to_stream_finish ()
gboolean | camel_data_wrapper_construct_from_stream_sync ()
void | camel_data_wrapper_construct_from_stream ()
gboolean | camel_data_wrapper_construct_from_stream_finish ()
gssize | camel_data_wrapper_write_to_output_stream_sync ()
void | camel_data_wrapper_write_to_output_stream ()
gssize | camel_data_wrapper_write_to_output_stream_finish ()
gssize | camel_data_wrapper_decode_to_output_stream_sync ()
void | camel_data_wrapper_decode_to_output_stream ()
gssize | camel_data_wrapper_decode_to_output_stream_finish ()
gboolean | camel_data_wrapper_construct_from_input_stream_sync ()
void | camel_data_wrapper_construct_from_input_stream ()
gboolean | camel_data_wrapper_construct_from_input_stream_finish ()
gsize | camel_data_wrapper_calculate_size_sync ()
gsize | camel_data_wrapper_calculate_decoded_size_sync ()

## Object Hierarchy

        GObject
        ╰── CamelDataWrapper
            ├── CamelMedium
            ╰── CamelMultipart

## Description

## Functions

### camel_data_wrapper_new ()

    CamelDataWrapper *
    camel_data_wrapper_new (void);

Create a new CamelDataWrapper object.

#### Returns

a new CamelDataWrapper object

### camel_data_wrapper_get_byte_array ()

    GByteArray *
    camel_data_wrapper_get_byte_array (CamelDataWrapper *data_wrapper);

Returns the GByteArray being used to hold the contents of `data_wrapper` .

Note, it's up to the caller to use this in a thread-safe manner.

#### Parameters

data_wrapper | a CamelDataWrapper |

#### Returns

the GByteArray for `data_wrapper` .

[transfer none]

Since: 3.2

### camel_data_wrapper_get_encoding ()

    CamelTransferEncoding
    camel_data_wrapper_get_encoding (CamelDataWrapper *data_wrapper);

#### Parameters

data_wrapper | a CamelDataWrapper |

#### Returns

An encoding (CamelTransferEncoding) of the `data_wrapper`

Since: 3.24

### camel_data_wrapper_set_encoding ()

    void
    camel_data_wrapper_set_encoding (CamelDataWrapper *data_wrapper,
                                     CamelTransferEncoding encoding);

Sets encoding (CamelTransferEncoding) for the `data_wrapper` . It doesn't re-encode the content, if the encoding changes.

#### Parameters

data_wrapper | a CamelDataWrapper |
encoding | an encoding to set |

Since: 3.24

### camel_data_wrapper_set_mime_type ()

    void
    camel_data_wrapper_set_mime_type (CamelDataWrapper *data_wrapper,
                                      const gchar *mime_type);

This sets the data wrapper's MIME type.

It might fail, but you won't know. It will allow you to set Content-Type parameters on the data wrapper, which are meaningless. You should not be allowed to change the MIME type of a data wrapper that contains data, or at least, if you do, it should invalidate the data.

#### Parameters

data_wrapper | a CamelDataWrapper |
mime_type | a MIME type |

### camel_data_wrapper_get_mime_type ()

    gchar *
    camel_data_wrapper_get_mime_type (CamelDataWrapper *data_wrapper);

#### Parameters

data_wrapper | a CamelDataWrapper |

#### Returns

the MIME type which must be freed by the caller

### camel_data_wrapper_get_mime_type_field ()

    CamelContentType *
    camel_data_wrapper_get_mime_type_field
                                   (CamelDataWrapper *data_wrapper);

#### Parameters

data_wrapper | a CamelDataWrapper |

#### Returns

the parsed form of the data wrapper's MIME type.

[transfer none]

### camel_data_wrapper_set_mime_type_field ()

    void
    camel_data_wrapper_set_mime_type_field
                                   (CamelDataWrapper *data_wrapper,
                                    CamelContentType *mime_type);

This sets the data wrapper's MIME type. It adds its own reference to `mime_type` , if not `NULL`.

It suffers from the same flaws as `camel_data_wrapper_set_mime_type()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
mime_type | a CamelContentType. | [nullable]

### camel_data_wrapper_take_mime_type_field ()

    void
    camel_data_wrapper_take_mime_type_field
                                   (CamelDataWrapper *data_wrapper,
                                    CamelContentType *mime_type);

Sets mime-type filed to be `mime_type` and consumes it, aka unlike `camel_data_wrapper_set_mime_type_field()`, this doesn't add its own reference to `mime_type` .

It suffers from the same flaws as `camel_data_wrapper_set_mime_type()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
mime_type | a CamelContentType. | [nullable][transfer full]

Since: 3.24

### camel_data_wrapper_is_offline ()

    gboolean
    camel_data_wrapper_is_offline (CamelDataWrapper *data_wrapper);

#### Parameters

data_wrapper | a CamelDataWrapper |

#### Returns

whether `data_wrapper` is "offline" (data stored remotely) or not. Some optional code paths may choose to not operate on offline data.

### camel_data_wrapper_set_offline ()

    void
    camel_data_wrapper_set_offline (CamelDataWrapper *data_wrapper,
                                    gboolean offline);

Sets whether the `data_wrapper` is "offline". It applies only to this concrete instance. See `camel_data_wrapper_is_offline()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
offline | whether the `data_wrapper` is "offline" |

Since: 3.24

### camel_data_wrapper_write_to_stream_sync ()

    gssize
    camel_data_wrapper_write_to_stream_sync
                                   (CamelDataWrapper *data_wrapper,
                                    CamelStream *stream,
                                    GCancellable *cancellable,
                                    GError **error);

Writes the content of `data_wrapper` to `stream` in a machine-independent format appropriate for the data. It should be possible to construct an equivalent data wrapper object later by passing this stream to `camel_data_wrapper_construct_from_stream_sync()`.

This function may block even if the given output stream does not. For example, the content may have to be fetched across a network before it can be written to `stream`.

#### Parameters

data_wrapper | a CamelDataWrapper |
stream | a CamelStream for output |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.0

### camel_data_wrapper_write_to_stream ()

    void
    camel_data_wrapper_write_to_stream (CamelDataWrapper *data_wrapper,
                                        CamelStream *stream,
                                        gint io_priority,
                                        GCancellable *cancellable,
                                        GAsyncReadyCallback callback,
                                        gpointer user_data);

Asynchronously writes the content of `data_wrapper` to `stream` in a machine-independent format appropriate for the data. It should be possible to construct an equivalent data wrapper object later by passing this stream to `camel_data_wrapper_construct_from_stream()`.

When the operation is finished, `callback` will be called. You can then call `camel_data_wrapper_write_to_stream_finish()` to get the result of the operation.

#### Parameters

data_wrapper | a CamelDataWrapper |
stream | a CamelStream for writed data to be written to |
io_priority | the I/O priority of the request |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.0

### camel_data_wrapper_write_to_stream_finish ()

    gssize
    camel_data_wrapper_write_to_stream_finish
                                   (CamelDataWrapper *data_wrapper,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `camel_data_wrapper_write_to_stream()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 or error

Since: 3.0

### camel_data_wrapper_decode_to_stream_sync ()

    gssize
    camel_data_wrapper_decode_to_stream_sync
                                   (CamelDataWrapper *data_wrapper,
                                    CamelStream *stream,
                                    GCancellable *cancellable,
                                    GError **error);

Writes the decoded data content to `stream` .

This function may block even if the given output stream does not. For example, the content may have to be fetched across a network before it can be written to `stream`.

#### Parameters

data_wrapper | a CamelDataWrapper |
stream | a CamelStream for decoded data to be written to |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.0

### camel_data_wrapper_decode_to_stream ()

    void
    camel_data_wrapper_decode_to_stream (CamelDataWrapper *data_wrapper,
                                         CamelStream *stream,
                                         gint io_priority,
                                         GCancellable *cancellable,
                                         GAsyncReadyCallback callback,
                                         gpointer user_data);

Asynchronously writes the decoded data content to `stream` .

When the operation is finished, `callback` will be called. You can then call `camel_data_wrapper_decode_to_stream_finish()` to get the result of the operation.

#### Parameters

data_wrapper | a CamelDataWrapper |
stream | a CamelStream for decoded data to be written to |
io_priority | the I/O priority of the request |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.0

### camel_data_wrapper_decode_to_stream_finish ()

    gssize
    camel_data_wrapper_decode_to_stream_finish
                                   (CamelDataWrapper *data_wrapper,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `camel_data_wrapper_decode_to_stream()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.0

### camel_data_wrapper_construct_from_stream_sync ()

    gboolean
    camel_data_wrapper_construct_from_stream_sync
                                   (CamelDataWrapper *data_wrapper,
                                    CamelStream *stream,
                                    GCancellable *cancellable,
                                    GError **error);

Constructs the content of `data_wrapper` from the given `stream` .

#### Parameters

data_wrapper | a CamelDataWrapper |
stream | an input CamelStream |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on error

Since: 3.0

### camel_data_wrapper_construct_from_stream ()

    void
    camel_data_wrapper_construct_from_stream
                                   (CamelDataWrapper *data_wrapper,
                                    CamelStream *stream,
                                    gint io_priority,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Asynchronously constructs the content of `data_wrapper` from the given `stream` .

When the operation is finished, `callback` will be called. You can then call `camel_data_wrapper_construct_from_stream_finish()` to get the result of the operation.

#### Parameters

data_wrapper | a CamelDataWrapper |
stream | an input CamelStream |
io_priority | the I/O priority of the request |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.0

### camel_data_wrapper_construct_from_stream_finish ()

    gboolean
    camel_data_wrapper_construct_from_stream_finish
                                   (CamelDataWrapper *data_wrapper,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `camel_data_wrapper_construct_from_stream()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on error

Since: 3.0

### camel_data_wrapper_write_to_output_stream_sync ()

    gssize
    camel_data_wrapper_write_to_output_stream_sync
                                   (CamelDataWrapper *data_wrapper,
                                    GOutputStream *output_stream,
                                    GCancellable *cancellable,
                                    GError **error);

Writes the content of `data_wrapper` to `output_stream` in a machine-independent format appropriate for the data.

This function may block even if the given output stream does not. For example, the content may have to be fetched across a network before it can be written to `output_stream`.

#### Parameters

data_wrapper | a CamelDataWrapper |
output_stream | a GOutputStream |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.12

### camel_data_wrapper_write_to_output_stream ()

    void
    camel_data_wrapper_write_to_output_stream
                                   (CamelDataWrapper *data_wrapper,
                                    GOutputStream *output_stream,
                                    gint io_priority,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Asynchronously writes the content of `data_wrapper` to `output_stream` in a machine-independent format appropriate for the data.

When the operation is finished, `callback` will be called. You can then call `camel_data_wrapper_write_to_output_stream_finish()` to get the result of the operation.

#### Parameters

data_wrapper | a CamelDataWrapper |
output_stream | a GOutputStream |
io_priority | the I/O priority of the request |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.12

### camel_data_wrapper_write_to_output_stream_finish ()

    gssize
    camel_data_wrapper_write_to_output_stream_finish
                                   (CamelDataWrapper *data_wrapper,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `camel_data_wrapper_write_to_output_stream()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.12

### camel_data_wrapper_decode_to_output_stream_sync ()

    gssize
    camel_data_wrapper_decode_to_output_stream_sync
                                   (CamelDataWrapper *data_wrapper,
                                    GOutputStream *output_stream,
                                    GCancellable *cancellable,
                                    GError **error);

Writes the decoded data content to `output_stream` .

This function may block even if the given output stream does not. For example, the content may have to be fetched across a network before it can be written to `output_stream`.

#### Parameters

data_wrapper | a CamelDataWrapper |
output_stream | a GOutputStream |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.12

### camel_data_wrapper_decode_to_output_stream ()

    void
    camel_data_wrapper_decode_to_output_stream
                                   (CamelDataWrapper *data_wrapper,
                                    GOutputStream *output_stream,
                                    gint io_priority,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Asynchronously writes the decoded data content to `output_stream` .

When the operation is finished, `callback` will be called. You can then call `camel_data_wrapper_decode_to_output_stream_finish()` to get the result of the operation.

#### Parameters

data_wrapper | a CamelDataWrapper |
output_stream | a GOutputStream |
io_priority | the I/O priority of the request |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.12

### camel_data_wrapper_decode_to_output_stream_finish ()

    gssize
    camel_data_wrapper_decode_to_output_stream_finish
                                   (CamelDataWrapper *data_wrapper,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `camel_data_wrapper_decode_to_output_stream()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

the number of bytes written, or -1 on error

Since: 3.12

### camel_data_wrapper_construct_from_input_stream_sync ()

    gboolean
    camel_data_wrapper_construct_from_input_stream_sync
                                   (CamelDataWrapper *data_wrapper,
                                    GInputStream *input_stream,
                                    GCancellable *cancellable,
                                    GError **error);

Constructs the content of `data_wrapper` from `input_stream` .

#### Parameters

data_wrapper | a CamelDataWrapper |
input_stream | a GInputStream |
cancellable | optional GCancellable object, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on error

Since: 3.12

### camel_data_wrapper_construct_from_input_stream ()

    void
    camel_data_wrapper_construct_from_input_stream
                                   (CamelDataWrapper *data_wrapper,
                                    GInputStream *input_stream,
                                    gint io_priority,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Asynchronously constructs the content of `data_wrapper` from `input_stream` .

When the operation is finished, `callback` will be called. You can then call `camel_data_wrapper_construct_from_input_stream_finish()` to get the result of the operation.

#### Parameters

data_wrapper | a CamelDataWrapper |
input_stream | a GInputStream |
io_priority | the I/O priority of the request |
cancellable | optional GCancellable object, or `NULL` |
callback | a GAsyncReadyCallback to call when the request is satisfied |
user_data | data to pass to the callback function |

Since: 3.12

### camel_data_wrapper_construct_from_input_stream_finish ()

    gboolean
    camel_data_wrapper_construct_from_input_stream_finish
                                   (CamelDataWrapper *data_wrapper,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the operation started with `camel_data_wrapper_construct_from_input_stream()`.

#### Parameters

data_wrapper | a CamelDataWrapper |
result | a GAsyncResult |
error | return location for a GError, or `NULL` |

#### Returns

`TRUE` on success, `FALSE` on error

Since: 3.12

### camel_data_wrapper_calculate_size_sync ()

    gsize
    camel_data_wrapper_calculate_size_sync
                                   (CamelDataWrapper *data_wrapper,
                                    GCancellable *cancellable,
                                    GError **error);

Calculates size of the `data_wrapper` by saving it to a null-stream and returns how many bytes had been written. It's using `camel_data_wrapper_write_to_stream_sync()` internally.

#### Parameters

data_wrapper | a CamelDataWrapper |
cancellable | a GCancellable, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

how many bytes the `data_wrapper` would use when saved, or -1 on error.

Since: 3.24

### camel_data_wrapper_calculate_decoded_size_sync ()

    gsize
    camel_data_wrapper_calculate_decoded_size_sync
                                   (CamelDataWrapper *data_wrapper,
                                    GCancellable *cancellable,
                                    GError **error);

Calculates decoded size of the `data_wrapper` by saving it to a null-stream and returns how many bytes had been written. It's using `camel_data_wrapper_decode_to_stream_sync()` internally.

#### Parameters

data_wrapper | a CamelDataWrapper |
cancellable | a GCancellable, or `NULL` |
error | return location for a GError, or `NULL` |

#### Returns

how many bytes the `data_wrapper` would use when saved, or -1 on error.

Since: 3.24