## SpiceURI

SpiceURI — URIs handling

## Stability Level

Stable, unless otherwise indicated

## Synopsis

    #include <spice-uri.h>

    const gchar *       spice_uri_get_scheme                (SpiceURI *uri);
    void                spice_uri_set_scheme                (SpiceURI *uri,
                                                             const gchar *scheme);
    const gchar *       spice_uri_get_hostname              (SpiceURI *uri);
    void                spice_uri_set_hostname              (SpiceURI *uri,
                                                             const gchar *hostname);
    guint               spice_uri_get_port                  (SpiceURI *uri);
    void                spice_uri_set_port                  (SpiceURI *uri,
                                                             guint port);
    const gchar *       spice_uri_get_user                  (SpiceURI *uri);
    void                spice_uri_set_user                  (SpiceURI *uri,
                                                             const gchar *user);
    const gchar *       spice_uri_get_password              (SpiceURI *uri);
    void                spice_uri_set_password              (SpiceURI *uri,
                                                             const gchar *password);
    gchar *             spice_uri_to_string                 (SpiceURI *uri);
                        SpiceURIClass;
                        SpiceURI;

## Description

A SpiceURI represents a (parsed) URI.

## Details

### spice_uri_get_scheme ()

    const gchar *       spice_uri_get_scheme                (SpiceURI *uri);

Gets `uri`'s scheme.

`uri` : | a SpiceURI
Returns : | `uri`'s scheme.

Since 0.24

### spice_uri_set_scheme ()

    void                spice_uri_set_scheme                (SpiceURI *uri,
                                                             const gchar *scheme);

Sets `uri`'s scheme to `scheme`.

`uri` : | a SpiceURI
`scheme` : | the scheme

Since 0.24

### spice_uri_get_hostname ()

    const gchar *       spice_uri_get_hostname              (SpiceURI *uri);

Gets `uri`'s hostname.

`uri` : | a SpiceURI
Returns : | `uri`'s hostname.

Since 0.24

### spice_uri_set_hostname ()

    void                spice_uri_set_hostname              (SpiceURI *uri,
                                                             const gchar *hostname);

Sets `uri`'s hostname to `hostname`.

`uri` : | a SpiceURI
`hostname` : | the hostname

Since 0.24

### spice_uri_get_port ()

    guint               spice_uri_get_port                  (SpiceURI *uri);

Gets `uri`'s port.

`uri` : | a SpiceURI
Returns : | `uri`'s port.

Since 0.24

### spice_uri_set_port ()

    void                spice_uri_set_port                  (SpiceURI *uri,
                                                             guint port);

Sets `uri`'s port to `port`.

`uri` : | a SpiceURI
`port` : | the port

Since 0.24

### spice_uri_get_user ()

    const gchar *       spice_uri_get_user                  (SpiceURI *uri);

Gets `uri`'s user.

`uri` : | a SpiceURI
Returns : | `uri`'s user.

Since 0.24

### spice_uri_set_user ()

    void                spice_uri_set_user                  (SpiceURI *uri,
                                                             const gchar *user);

Sets `uri`'s user to `user`.

`uri` : | a SpiceURI
`user` : | the user, or `NULL`.

Since 0.24

### spice_uri_get_password ()

    const gchar *       spice_uri_get_password              (SpiceURI *uri);

Gets `uri`'s password.

`uri` : | a SpiceURI
Returns : | `uri`'s password.

Since 0.24

### spice_uri_set_password ()

    void                spice_uri_set_password              (SpiceURI *uri,
                                                             const gchar *password);

Sets `uri`'s password to `password`.

`uri` : | a SpiceURI
`password` : | the password, or `NULL`.

Since 0.24

### spice_uri_to_string ()

    gchar *             spice_uri_to_string                 (SpiceURI *uri);

Returns a string representing `uri`.

`uri` : | a SpiceURI
Returns : | a string representing `uri`, which the caller must free.

Since 0.24

### SpiceURIClass

    typedef struct _SpiceURIClass SpiceURIClass;

### SpiceURI

    typedef struct _SpiceURI SpiceURI;