Method
GioFileload_bytes
Declaration
GBytes*
g_file_load_bytes (
GFile* file,
GCancellable* cancellable,
gchar** etag_out,
GError** error
)
Description
Loads the contents of file
and returns it as GBytes
.
If file
is a resource:// based URI, the resulting bytes will reference the
embedded resource instead of a copy. Otherwise, this is equivalent to calling
g_file_load_contents()
and g_bytes_new_take().
For resources, etag_out
will be set to NULL
.
The data contained in the resulting GBytes
is always zero-terminated, but
this is not included in the GBytes
length. The resulting GBytes
should be
freed with g_bytes_unref()
when no longer in use.
Available since: | 2.56 |
Parameters
cancellable |
GCancellable |
A |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
etag_out |
gchar** |
A location to place the current
entity tag for the file, or |
|
The argument will be set by the function. | |
The argument can be set to NULL . | |
The argument can be NULL . | |
The instance takes ownership of the data, and is responsible for freeing it. | |
The value is a NUL terminated UTF-8 string. | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | GBytes |
A |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. |