SIP_GET_URI_PARSED(3SIP) Session Initiation Protocol Library Functions
NAME
sip_get_uri_parsed - return the parsed URI
SYNOPSIS
cc [
flag ... ]
file ...
-lsip [
library ... ]
#include <sip.h>
const struct sip_uri *sip_get_uri_parsed(
sip_header_value_t value,
int *error);
DESCRIPTION
The
sip_get_uri_parsed() function returns the parsed
URI sip_uri from
the
SIP header value specified in
value.
RETURN VALUES
The
sip_get_uri_parsed() function returns the parsed
URI sip_uri on
success. The function returns
NULL on failure.
The value of
errno is not changed by these calls in the event of an
error.
ERRORS
If the error is non-null, following value is set:
EINVAL The
SIP header value of the
SIP message is
NULL or there is
no
URI.
The input
URI is null or the requested
URI component is
invalid. The error flag is set for the requested
component.
The
URI parameters or headers are requested from a
non-
SIP[S] URI; or the '
opaque', '
query', '
path', '
reg- name' components are requested from a
SIP[S] URI.
On success, the value of the location pointed to by
error is set to
0.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
libsip(3LIB) January 25, 2007 SIP_GET_URI_PARSED(3SIP)
