gboolean g_file_get_contents ( const gchar* filename, gchar** contents, gsize* length, GError** error )
Reads an entire file into allocated memory, with good error checking.
If the call was successful, it returns
TRUE and sets
contents to the file
length to the length of the file contents in bytes. The string
contents will be nul-terminated, so for text files you can pass
NULL for the
length argument. If the call was not successful, it returns
FALSE and sets
error. The error domain is
G_FILE_ERROR. Possible error
codes are those in the
GFileError enumeration. In the error case,
contents is set to
length is set to zero.
Available since: 2.0
Name of a file to read contents from, in the GLib file name encoding.
The data is owned by the caller of the function. The value is a file system path, using the OS encoding.
Type: An array of
Location to store an allocated string, use
g_free()to free the returned string.
The argument will be set by the function. The length of the array is specified in the
The caller of the function takes ownership of the returned data, and is responsible for freeing it.
Location to store length in bytes of the contents, or
The argument will be set by the function. The argument can be set to
NULLby the function.
The return location for a recoverable error.
The argument can be
If the return location is not
NULL, then you must initialize it to a
The argument will be left initialized to
NULLby the function if there are no errors.
In case of error, the argument will be set to a newly allocated
GError; the caller will take ownership of the data, and be responsible for freeing it.