函数

GLibfilename_to_uri

申明 [src]

gchar*
g_filename_to_uri (
  const gchar* filename,
  const gchar* hostname,
  GError** error
)

说明 [src]

将绝对路径的文件名转换为已转义的 ASCII 编码的 URI，路径组件遵循 RFC 2396 的第 3.3 节。

参数

filename

类型： const gchar*

绝对路径的文件名，在 GLib 文件名编码中指定，Unix 上磁盘文件名字节和 Windows 上的 UTF-8。

数据由函数调用者所有。
值是平台上本地的字符串，Unix 上使用首选操作系统编码，Windows 上使用 UTF-8。
hostname

类型： const gchar*

UTF-8 编码的主机名，或 NULL 表示无。

参数可以为 NULL。
数据由函数调用者所有。
值是使用 NUL 终止的 UTF-8 字符串。
error

类型： GError **

可恢复错误 的返回位置。

参数可以为 NULL。
如果返回位置不为 NULL，则必须初始化为 NULL GError*。
如果没有错误，函数会将参数初始化为 NULL。
如果出错，参数将设置为新建的 GError；调用者负责该数据所有权，并负责释放它。

返回值

类型： gchar*

一个新分配的字符串，保存结果 URI，或者如果出错，则保存 NULL。

函数调用者负责该数据所有权，并负责释放它。
值是使用 NUL 终止的 UTF-8 字符串。