函数

自 2.66 起可用

声明 [src]

gboolean
g_uri_split_with_user (
  const gchar* uri_ref,
  GUriFlags flags,
  gchar** scheme,
  gchar** user,
  gchar** password,
  gchar** auth_params,
  gchar** host,
  gint* port,
  gchar** path,
  gchar** query,
  gchar** fragment,
  GError** error
)

描述 [src]

根据 flags 解析 uri_ref(可以是相对或绝对 URI),并返回片段。任何未出现在 uri_ref 中的组件将返回 NULL(但请注意,所有 URI 总是有一个路径组件,尽管它可能是空字符串)。

有关 flags 的更多信息,请参阅 g_uri_split() 和 GUriFlags 的定义。注意,如果 flags 包含 G_URI_FLAGS_HAS_PASSWORD,则会解析 password,如果 flags 包含 G_URI_FLAGS_HAS_AUTH_PARAMS,则会解析 auth_params

自 2.66 起可用

参数

uri_ref

类型: const gchar*

包含相对或绝对 URI 的字符串。

数据由函数的调用者拥有。
该值是 NULL 结束的 UTF-8 字符串。
flags

类型: GUriFlags

解析 uri_ref 的标志。

scheme

类型: gchar**

返回时,包含方案(转换为小写),或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
user

类型: gchar**

返回时,包含用户,或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
password

类型: gchar**

返回时,包含密码,或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
auth_params

类型: gchar**

返回时,包含 auth_params,或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
host

类型: gchar**

返回时,包含主机,或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
port

类型: gint*

返回时,包含端口,或 -1

该参数将由函数设置。
该参数可以是 NULL
path

类型: gchar**

返回时,包含路径。

该参数将由函数设置。
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
query

类型: gchar**

返回时,包含查询,或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
fragment

类型: gchar**

返回时,包含片段,或 NULL

该参数将由函数设置。
函数可以将参数设置为 NULL
该参数可以是 NULL
调用函数的用户将拥有返回的数据,并负责释放它。
该值是 NULL 结束的 UTF-8 字符串。
error

类型: GError **

恢复错误的返回位置。

该参数可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,该函数将把参数初始化为NULL
如果发生错误,参数将被设为一个新的分配的GError;调用者将获取该数据的所有权,并负责释放它。

返回值

类型: gboolean

TRUE表示uri_ref解析成功,发生错误时为FALSE