虚拟方法

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,调用者将拥有数据,并负责释放它。

返回值

类型: GFile

指定子项的GFile,或如果不能转换显示名则返回NULL。使用g_object_unref()释放返回的对象。

方法调用者拥有返回的数据,并负责释放它。