函数

GLibUrijoin

since: 2.66

声明 [src]

gchar*
g_uri_join (
  GUriFlags flags,
  const gchar* scheme,
  const gchar* userinfo,
  const gchar* host,
  gint port,
  const gchar* path,
  const gchar* query,
  const gchar* fragment
)

描述 [src]

根据 flags 将给定的组件连接在一起,创建一个绝对 URI 字符串。 path 不可以为 NULL(尽管它可以是空字符串)。

host 存在时,path 必须为空或以斜杠(/)字符开始。当 host 不存在时,path 不能以两个斜杠字符(//)开头。参见 RFC 3986,第 3 节

另请参阅 g_uri_join_with_user(),它允许分别指定 'userinfo' 的组件。

G_URI_FLAGS_HAS_PASSWORDG_URI_FLAGS_HAS_AUTH_PARAMS 如果在 flags 中设置,将被忽略。

Available since: 2.66

参数

flags

类型: GUriFlags

描述如何构建 URI 字符串的标志。

scheme

类型: const gchar*

URI 方案,或 NULL

该参数可以为 NULL
数据由函数的调用者拥有。
值是一个以空字符终止的 UTF-8 字符串。
userinfo

类型: const gchar*

userinfo 组件,或 NULL

该参数可以为 NULL
数据由函数的调用者拥有。
值是一个以空字符终止的 UTF-8 字符串。
host

类型: const gchar*

host 组件,或 NULL

该参数可以为 NULL
数据由函数的调用者拥有。
值是一个以空字符终止的 UTF-8 字符串。
port

类型: gint

端口,或 -1

path

类型: const gchar*

路径组件。

数据由函数的调用者拥有。
值是一个以空字符终止的 UTF-8 字符串。
query

类型: const gchar*

查询组件,或 NULL

该参数可以为 NULL
数据由函数的调用者拥有。
值是一个以空字符终止的 UTF-8 字符串。
fragment

类型: const gchar*

片段,或 NULL

该参数可以为 NULL
数据由函数的调用者拥有。
值是一个以空字符终止的 UTF-8 字符串。

返回值

类型: gchar*

一个绝对 URI 字符串。

函数的调用者拥有数据,并负责释放它。
值是一个以空字符终止的 UTF-8 字符串。