函数

GioFilenew_for_commandline_arg

声明 [源]

GFile*
g_file_new_for_commandline_arg (
  const char* arg
)

描述 [源]

创建一个使用给定命令行参数的 GFile。参数 arg 可以是一个 URI 或绝对路径或相对于当前工作目录解析的相对路径。此操作永远不会失败，但如果 arg 指向一个格式不正确的路径，则返回的对象可能不支持任何 I/O 操作。

请注意，在 Windows 上，此函数期望其参数以 UTF-8 编码 —— 而不是系统代码页。这意味着您不应该使用传入主()的 argv 字符串调用此函数。g_win32_get_command_line() 将返回命令行的 UTF-8 版本。GApplication 也使用 UTF-8，但您可能更希望在那里使用 g_application_command_line_create_file_for_arg()。始终可以使用此函数与 GOptionContext 的 G_OPTION_ARG_FILENAME 类型的参数一起使用。

参数

arg

类型： const char*

命令行字符串。

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

值是一个平台本机字符串，在 Unix 上使用首选 OS 编码，在 Windows 上使用 UTF-8。

返回值

类型： GFile

一个新的 GFile。使用 g_object_unref() 释放返回的对象。

函数的调用者拥有数据，并负责释放它。