GLibfilename_from_uri

gchar*
g_filename_from_uri (
  const gchar* uri,
  gchar** hostname,
  GError** error
)

将转义的 ASCII 编码的 URI 转换为使用适用于文件名的编码的本地文件名。

自 GLib 2.78 起，查询字符串和片段可以出现在 URI 中，但不是结果文件名的一部分。我们从 https://url.spec.whatwg.org/#file-state 中吸取灵感，但我们不支持整个标准。

uri

类型： const gchar*

描述文件名的 uri（已转义并使用 ASCII 编码）。

数据由函数的调用者所有。

该值为以空字符结尾的 UTF-8 字符串。

hostname

类型： gchar**

为 URI 存储主机名的位置。如果 URI 中没有主机名，则该位置将存储 NULL。

该参数将由函数设置。

该参数可由函数设置为 NULL。

该参数可为 NULL。

函数的调用者获取返回数据的占有权，并负责释放它。

该值为以空字符结尾的 UTF-8 字符串。

error

类型： GError **

可恢复错误的返回位置。

该参数可为 NULL。

如果返回位置不为 NULL，那么必须将其初始化为 NULL GError*。

如果不存在错误，该参数将被函数留空初始化为 NULL。

如果出错，该参数将被设置为一个新分配的 GError；调用者将取得该数据的占有权并负责释放它。

类型： gchar*

一个新分配的字符串，保存结果文件名或在这种情况下为 NULL。

函数的调用者获取返回数据的占有权，并负责释放它。

该值为平台原生字符串，在 Unix 上使用首选 OS 编码，在 Windows 上使用 UTF-8。