Function

GLibUrijoin_with_user

Declaration

gchar*
g_uri_join_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
)

Description

Joins the given components together according to flags to create an absolute URI string. path may not be NULL (though it may be the empty string).

In contrast to g_uri_join(), this allows specifying the components of the ‘userinfo’ separately. It otherwise behaves the same.

G_URI_FLAGS_HAS_PASSWORD and G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in flags.

Available since:2.66

Parameters

flags

Type: GUriFlags

Flags describing how to build the URI string.

scheme

Type: const gchar*

The URI scheme, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
user

Type: const gchar*

The user component of the userinfo, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
password

Type: const gchar*

The password component of the userinfo, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
auth_params

Type: const gchar*

The auth params of the userinfo, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
host

Type: const gchar*

The host component, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
port

Type: gint

The port, or -1

path

Type: const gchar*

The path component.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
query

Type: const gchar*

The query component, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
fragment

Type: const gchar*

The fragment, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: gchar*

An absolute URI string.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.