Method

GLibUriparse_relative

Declaration

GUri*
g_uri_parse_relative (
  GUri* base_uri,
  const gchar* uri_ref,
  GUriFlags flags,
  GError** error
)

Description

Parses uri_ref according to flags and, if it is a [relative URI][relative-absolute-uris], resolves it relative to base_uri. If the result is not a valid absolute URI, it will be discarded, and an error returned.

Available since:

2.66

Parameters

uri_ref

Type: const gchar*

A string representing a relative or absolute URI.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

flags

Type: GUriFlags

Flags describing how to parse uri_ref.

error

Type: GError **

The return location for an error.

The argument can be NULL.

The argument will be set to NULL by the function if there are no errors.

In case of error, the argument will be set and the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: GUri

A new GUri, or NULL on error.

The caller of the method takes ownership of the data, and is responsible for freeing it.