方法

GioFileget_child_for_display_name

声明 [源]

GFile*
g_file_get_child_for_display_name (
  GFile* file,
  const char* display_name,
  GError** error
)

描述 [源]

获取给定display_name(即名称的UTF-8版本)的file的子文件。如果此函数失败，则返回NULL，并且error将被设置。这在为新文件构建GFile并且用户在用户界面中输入了文件名时非常有用，例如，在您选择目录并输入文件名时。

此调用不执行阻塞I/O。

参数

display_name

类型: const char*

指向可能子文件的字符串。

数据由方法的调用者拥有。
值是一个以null结尾的UTF-8字符串。
error

类型: GError **

可用错误的返回位置。

参数可以是NULL。
如果返回位置不是NULL，则必须将其初始化为零的GError*。
如果没有错误，方法将使用NULL初始化参数。
如果发生错误，将使用新分配的GError设置参数；调用者将拥有数据，并负责释放它。

返回值

类型: GFile

指向特定子文件的GFile，或者在无法转换显示名称时为NULL。使用g_object_unref()释放返回的对象。

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