Function
Valentget_user_file
unstable since: 1.0
Declaration [src]
GFile*
valent_get_user_file (
const char* dirname,
const char* basename,
gboolean unique
)
Description [src]
A convenience for creating a GFile.
If unique is true, the returned file is guaranteed not to exist. If
basename exists in dirname, the resulting file’s name will have a
parenthesized number appended to it (e.g. image.png (2)).
Available since: 1.0
Parameters
dirname-
Type:
const char*A directory path.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. basename-
Type:
const char*A file name.
The data is owned by the caller of the function. The value is a platform-native string, using the preferred OS encoding on Unix and UTF-8 on Windows. unique-
Type:
gbooleanWhether the resulting filepath should be unique.
Return value
Type: GFile
A GFile.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |