fileGetContents

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 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 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 null and length is set to zero.

bool
fileGetContents
(
string filename
,
out ubyte[] contents
)

Parameters

filename string

name of a file to read contents from, in the GLib file name encoding

contents ubyte[]

location to store an allocated string, use glib.global.gfree to free the returned string

Return Value

Type: bool

true on success, false if an error occurred