URI Utilities: libsoup Reference Manual

## URI Utilities URI Utilities — Functions to help working with GUri and HTTP |

## Functions

gboolean | soup_uri_equal ()
GBytes * | soup_uri_decode_data_uri ()
GUri * | soup_uri_copy ()

## Types and Values

#define | SOUP_HTTP_URI_FLAGS
enum | SoupURIComponent

## Includes

    #include <libsoup/soup.h>

## Description

Utility functions and defines to help working with URIs.

## Functions

### soup_uri_equal ()

    gboolean
    soup_uri_equal (GUri *uri1,
                    GUri *uri2);

Tests whether or not `uri1` and `uri2` are equal in all parts

#### Parameters

uri1 | a GUri |
uri2 | another GUri |

#### Returns

`TRUE` if equal otherwise `FALSE`

### soup_uri_decode_data_uri ()

    GBytes *
    soup_uri_decode_data_uri (const char *uri,
                              char **content_type);

Decodes the given data URI and returns its contents and `content_type` .

#### Parameters

uri | a data URI, in string form |
content_type | location to store content type, or `NULL`. | [out][nullable][transfer full]

#### Returns

a GBytes with the contents of `uri` , or `NULL` if `uri` is not a valid data URI.

[transfer full]

### soup_uri_copy ()

    GUri *
    soup_uri_copy (GUri *uri,
                   SoupURIComponent first_component,
                   ...);

Return a copy of `uri` with the given components updated

[skip]

#### Parameters

uri | the GUri to copy |
first_component | first SoupURIComponent to update |
... | value of `first_component` followed by additional components and values, terminated by `SOUP_URI_NONE` |

#### Returns

a new GUri.

[transfer full]

## Types and Values

### SOUP_HTTP_URI_FLAGS

    #define SOUP_HTTP_URI_FLAGS (G_URI_FLAGS_HAS_PASSWORD | G_URI_FLAGS_ENCODED_PATH | G_URI_FLAGS_ENCODED_QUERY | G_URI_FLAGS_ENCODED_FRAGMENT | G_URI_FLAGS_SCHEME_NORMALIZE)

The set of GUriFlags libsoup expects all GUri to use.

### enum SoupURIComponent

Enum values passed to `soup_uri_copy()` to indicate the components of the URI that should be updated with the given values.

#### Members

SOUP_URI_NONE | no component |
SOUP_URI_SCHEME | the URI scheme component |
SOUP_URI_USER | the URI user component |
SOUP_URI_PASSWORD | the URI password component |
SOUP_URI_AUTH_PARAMS | the URI authentication parameters component |
SOUP_URI_HOST | the URI host component |
SOUP_URI_PORT | the URI port component |
SOUP_URI_PATH | the URI path component |
SOUP_URI_QUERY | the URI query component |
SOUP_URI_FRAGMENT | the URI fragment component |