函数
自 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
;调用者将获取该数据的所有权,并负责释放它。