函数
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。
| 函数的调用者拥有数据,并负责释放它。 |