uri.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
struct ast_uri *	ast_uri_copy_replace (const struct ast_uri *uri, const char *scheme, const char *user_info, const char *host, const char *port, const char *path, const char *query)
	Copy the given uri replacing any value in the new uri with any given. More...
struct ast_uri *	ast_uri_create (const char *scheme, const char *user_info, const char *host, const char *port, const char *path, const char *query)
	Create a uri with the given parameters. More...
const char *	ast_uri_host (const struct ast_uri *uri)
	Retrieve the uri host. More...
int attribute_pure	ast_uri_is_secure (const struct ast_uri *uri)
	Retrieve if the uri is of a secure type. More...
char *	ast_uri_make_host_with_port (const struct ast_uri *uri)
	Retrieve a string of the host and port. More...
struct ast_uri *	ast_uri_parse (const char *uri)
	Parse the given uri into a structure. More...
struct ast_uri *	ast_uri_parse_http (const char *uri)
	Parse the given http uri into a structure. More...
struct ast_uri *	ast_uri_parse_websocket (const char *uri)
	Parse the given websocket uri into a structure. More...
const char *	ast_uri_path (const struct ast_uri *uri)
	Retrieve the uri path. More...
const char *	ast_uri_port (const struct ast_uri *uri)
	Retrieve the uri port. More...
const char *	ast_uri_query (const struct ast_uri *uri)
	Retrieve the uri query parameters. More...
const char *	ast_uri_scheme (const struct ast_uri *uri)
	Retrieve the uri scheme. More...
const char *	ast_uri_user_info (const struct ast_uri *uri)
	Retrieve the uri user information. More...

Function Documentation

ast_uri_copy_replace()

struct ast_uri * ast_uri_copy_replace	(	const struct ast_uri *	uri,
		const char *	scheme,
		const char *	user_info,
		const char *	host,
		const char *	port,
		const char *	path,
		const char *	query
	)

Copy the given uri replacing any value in the new uri with any given.

Parameters

uri	the uri object to copy
scheme	the uri scheme (ex: http)
user_info	user credentials (ex: <name>@<pass>)
host	host name or ip address
port	the port
path	the path
query	query parameters

Returns

a copy of the given uri with specified values replaced.

Return values

NULL

on error

Since

13

Definition at line 101 of file uri.c.

{
    return ast_uri_create(
        scheme ? scheme : uri->scheme,
        user_info ? user_info : uri->user_info,
        host ? host : uri->host,
        port ? port : uri->port,
        path ? path : uri->path,
        query ? query : uri->query);
}

References ast_uri_create(), ast_uri::host, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, ast_uri::uri, and ast_uri::user_info.

Referenced by uri_parse_and_default().

ast_uri_create()

struct ast_uri * ast_uri_create	(	const char *	scheme,
		const char *	user_info,
		const char *	host,
		const char *	port,
		const char *	path,
		const char *	query
	)

Create a uri with the given parameters.

Parameters

scheme	the uri scheme (ex: http)
user_info	user credentials (ex: <name>@<pass>)
host	host name or ip address
port	the port
path	the path
query	query parameters

Returns

a structure containing parsed uri data.

Return values

NULL

on error

Since

13

Definition at line 88 of file uri.c.

{
    return ast_uri_create_(
        scheme, scheme ? strlen(scheme) + 1 : 0,
        user_info, user_info ? strlen(user_info) + 1 : 0,
        host, host ? strlen(host) + 1 : 0,
        port, port ? strlen(port) + 1 : 0,
        path, path ? strlen(path) + 1 : 0,
        query, query ? strlen(query) + 1 : 0);
}

References ast_uri_create_(), ast_uri::host, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, and ast_uri::user_info.

Referenced by ast_uri_copy_replace().

ast_uri_host()

const char * ast_uri_host

(

const struct ast_uri *

uri

)

Retrieve the uri host.

Returns

the uri host.

Since

13

Definition at line 125 of file uri.c.

{
    return uri->host;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), and ast_uri_make_host_with_port().

ast_uri_is_secure()

int attribute_pure ast_uri_is_secure

(

const struct ast_uri *

uri

)

Retrieve if the uri is of a secure type.

Note

Secure types are recognized by an 's' at the end of the scheme.

Return values

True	if secure.
False	otherwise.

Since

13

Definition at line 145 of file uri.c.

{
    return ast_strlen_zero(uri->scheme) ? 0 :
        *(uri->scheme + strlen(uri->scheme) - 1) == 's';
}

References ast_strlen_zero(), and ast_uri::uri.

Referenced by AST_TEST_DEFINE(), and uri_parse_and_default().

ast_uri_make_host_with_port()

char * ast_uri_make_host_with_port

(

const struct ast_uri *

uri

)

Retrieve a string of the host and port.

Combine the host and port (<host>:<port>) if the port is available, otherwise just return the host.

Note

Caller is responsible for release the returned string.

Parameters

uri	the uri object

Returns

a string value of the host and optional port.

Since

13

Definition at line 300 of file uri.c.

{
    char *res;
 
    if (ast_asprintf(&res, "%s%s%s",
            ast_uri_host(uri) ?: "",
            ast_uri_port(uri) ? ":" : "",
            ast_uri_port(uri) ?: "") == -1) {
        return NULL;
    }
 
    return res;
}

References ast_asprintf, ast_uri_host(), ast_uri_port(), NULL, and ast_uri::uri.

Referenced by websocket_client_parse_uri().

ast_uri_parse()

struct ast_uri * ast_uri_parse

(

const char *

uri

)

Parse the given uri into a structure.

Note

Expects the following form:

<scheme>://[user:pass@]<host>[:port][/<path>] 

Parameters

uri	a string uri to parse

Returns

a structure containing parsed uri data.

Return values

NULL

on error

Since

13

Definition at line 195 of file uri.c.

{
#define SET_VALUES(value) \
    value = uri; \
    size_##value = p - uri + 1; \
    uri = p + 1;
 
    const char *p, *scheme = NULL, *user_info = NULL, *host = NULL;
    const char *port = NULL, *path = NULL, *query = NULL;
    unsigned int size_scheme = 0, size_user_info = 0, size_host = 0;
    unsigned int size_port = 0, size_path = 0, size_query = 0;
 
    if ((p = strstr(uri, "://"))) {
        scheme = uri;
        size_scheme = p - uri + 1;
        uri = p + 3;
    }
 
    if ((p = strchr(uri, '@'))) {
        SET_VALUES(user_info);
    }
 
    if ((p = strchr(uri, ':'))) {
        SET_VALUES(host);
    }
 
    if ((p = strchr(uri, '/'))) {
        if (!host) {
            SET_VALUES(host);
        } else {
            SET_VALUES(port);
        }
    }
 
    if ((p = strchr(uri, '?'))) {
        query = p + 1;
        size_query = strlen(query) + 1;
    } else {
        p = uri + strlen(uri);
    }
 
    if (!host) {
        SET_VALUES(host);
    } else if (*(uri - 1) == ':') {
        SET_VALUES(port);
    } else if (*(uri - 1) == '/') {
        SET_VALUES(path);
    }
 
    return ast_uri_create_(scheme, size_scheme,
                   user_info, size_user_info,
                   host, size_host,
                   port, size_port,
                   path, size_path,
                   query, size_query);
}

References ast_uri_create_(), ast_uri::host, NULL, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, SET_VALUES, ast_uri::uri, and ast_uri::user_info.

Referenced by AST_TEST_DEFINE(), file_extension_from_url_path(), and uri_parse_and_default().

ast_uri_parse_http()

struct ast_uri * ast_uri_parse_http

(

const char *

uri

)

Parse the given http uri into a structure.

Note

Expects the following form:

[http[s]://][user:pass@]<host>[:port][/<path>] 

If no scheme is given it defaults to 'http' and if no port is specified it will default to 443 if marked secure, otherwise to 80.

Parameters

uri	an http string uri to parse

Returns

a structure containing parsed http uri data.

Return values

NULL

on error

Since

13

Definition at line 290 of file uri.c.

{
    return uri_parse_and_default(uri, "http", "80", "443");
}

References ast_uri::uri, and uri_parse_and_default().

Referenced by AST_TEST_DEFINE().

ast_uri_parse_websocket()

struct ast_uri * ast_uri_parse_websocket

(

const char *

uri

)

Parse the given websocket uri into a structure.

Note

Expects the following form:

If no scheme is given it defaults to 'ws' and if no port is specified it will default to 443 if marked secure, otherwise to 80.

Parameters

uri	a websocket string uri to parse

Returns

a structure containing parsed http uri data.

Return values

NULL

on error

Since

13

Definition at line 295 of file uri.c.

{
    return uri_parse_and_default(uri, "ws", "80", "443");
}

References ast_uri::uri, and uri_parse_and_default().

Referenced by websocket_client_parse_uri().

ast_uri_path()

const char * ast_uri_path

(

const struct ast_uri *

uri

)

Retrieve the uri path.

Returns

the uri path.

Since

13

Definition at line 135 of file uri.c.

{
    return uri->path;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), file_extension_from_url_path(), and websocket_client_parse_uri().

ast_uri_port()

const char * ast_uri_port

(

const struct ast_uri *

uri

)

Retrieve the uri port.

Returns

the uri port.

Since

13

Definition at line 130 of file uri.c.

{
    return uri->port;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), ast_uri_make_host_with_port(), and uri_parse_and_default().

ast_uri_query()

const char * ast_uri_query

(

const struct ast_uri *

uri

)

Retrieve the uri query parameters.

Returns

the uri query parameters.

Since

13

Definition at line 140 of file uri.c.

{
    return uri->query;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), and websocket_client_parse_uri().

ast_uri_scheme()

const char * ast_uri_scheme

(

const struct ast_uri *

uri

)

Retrieve the uri scheme.

Returns

the uri scheme.

Since

13

Definition at line 115 of file uri.c.

{
    return uri->scheme;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE().

ast_uri_user_info()

const char * ast_uri_user_info

(

const struct ast_uri *

uri

)

Retrieve the uri user information.

Returns

the uri user information.

Since

13

Definition at line 120 of file uri.c.

{
    return uri->user_info;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE().