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 contents and
contents.length to the length of the file contents in bytes. The string stored in
contents will be nul-terminated, so for
text files you can pass null for the
contents.length argument. If the call was not successful, it
returns false and sets throws. The error domain is
FileError. Possible error codes are those in the
FileError enumeration. In the error case,
contents is set to
contents.length is set to zero.
name of a file to read contents from, in the GLib file name encoding
location to store an allocated string, use g_free to free the returned string
location to store length in bytes of the contents, or null
true on success, false if an error occurred