函数
GLibUribuild_with_user
since: 2.66
声明 [src]
GUri*
g_uri_build_with_user (
GUriFlags flags,
const gchar* scheme,
const gchar* user,
const gchar* password,
const gchar* auth_params,
const gchar* host,
gint port,
const gchar* path,
const gchar* query,
const gchar* fragment
)
描述 [src]
根据给定的组件和 flags
(无条件地添加 G_URI_FLAGS_HAS_PASSWORD
)创建一个新的 GUri
。 flags
必须与传递的值保持一致,特别是在使用 G_URI_FLAGS_ENCODED
时使用 % 编码的值。
与 g_uri_build() 不同的是,此函数允许分别指定 'userinfo' 字段的组件。注意,如果 password
或 auth_params
为非 NULL
,则 user
必须非 NULL
。
自 2.66 以来可用
参数
flags
-
类型:
GUriFlags
描述如何构建
GUri
的标志。 scheme
-
类型:
const gchar*
URI 方案。
数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 user
-
类型:
const gchar*
userinfo 组件中的用户部分,或
NULL
。参数可以 NULL
。数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 password
-
类型:
const gchar*
userinfo 组件中的密码部分,或
NULL
。参数可以 NULL
。数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 auth_params
-
类型:
const gchar*
userinfo 的认证参数,或
NULL
。参数可以 NULL
。数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 host
-
类型:
const gchar*
主机组件,或
NULL
。参数可以 NULL
。数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 port
-
类型:
gint
端口号,或
-1
。 path
-
类型:
const gchar*
路径组件。
数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 query
-
类型:
const gchar*
查询组件,或
NULL
。参数可以 NULL
。数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。 fragment
-
类型:
const gchar*
片段,或
NULL
。参数可以 NULL
。数据由函数的调用者拥有。 值是 NUL 终止的 UTF-8 字符串。
返回值
类型: GUri
一个新的 GUri
。
函数的调用者拥有数据,并负责释放它。 |