虚拟方法
GioFileget_child_for_display_name
声明 [源代码]
GFile*
get_child_for_display_name (
GFile* file,
const char* display_name,
GError** error
)
描述 [源代码]
获取指定 file
的子项,通过给定的 display_name
(即名称的UTF-8版本)。如果该函数失败,则返回NULL,并将错误设置到error。当构建新的GFile
(例如,当用户在用户界面中输入文件名时,如选择目录并在文件选择器中键入文件名)时,此功能非常有用。
此调用不执行拦截I/O。
参数
display_name
-
类型:
const char*
可能子项的字符串。
数据由方法调用者拥有。 该值是一个以NUL终止的UTF-8字符串。 error
-
类型:
GError **
一个可恢复错误的返回位置。
该参数可以是NULL。 如果返回位置不为NULL,则必须将其初始化为一个NULL GError*
。如果没有错误,则虚拟函数会将该参数初始化为NULL。 如果出现错误,该参数将被设置为一个新的 GError
,调用者将拥有数据,并负责释放它。