Method
GioFileget_child_for_display_name
Declaration
GFile*
g_file_get_child_for_display_name (
GFile* file,
const char* display_name,
GError** error
)
Description
Gets the child of file
for a given display_name
(i.e. a UTF-8
version of the name). If this function fails, it returns NULL
and error
will be set. This is very useful when constructing a
GFile
for a new file and the user entered the filename in the
user interface, for instance when you select a directory and
type a filename in the file selector.
This call does no blocking I/O.
Parameters
display_name |
const char* |
String to a possible child. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | GFile |
A |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. |