Description

The sip_str_ptr parameter points to the start of the returned value and
sip_str_len supplies the length of the returned value.

For example, given the following request line in a SIP message input
to sip_get_request_uri_str():

INVITE sip:marconi@radio.org SIP/2.0

the return is a pointer to sip_str_t with the sip_str_ptr member pointing
to “s” of sip:marconi@radio.org and sip_str_len being set to 21, the length of
sip:marconi@radio.org.

The sip_is_sip_uri() function takes a parsed URI sip_uri and returns B_TRUE if
it is a SIP[S] URI and B_FALSE if it is not. A
URI is a SIP[S] URI if the scheme in the URI is either
“sip” or “sips”.

The sip_get_uri_user() function takes a parsed URI sip_uri and returns the value
of the “user” component, if present.

The sip_get_uri_password() function takes a parsed URI sip_uri and returns the value
of the “password” component, if present.

The sip_get_uri_host() function takes a parsed URI sip_uri and returns the value
of the “host” component, if present.

The sip_get_uri_port() function takes a parsed URI sip_uri and returns the value
of the “port” component, if present.

The sip_get_uri_params() function takes a parsed URI sip_uri and returns the list
of URI parameters, if present, from a SIP[S] URI.

The sip_get_uri_headers() function takes a parsed URI sip_uri and returns 'headers' from
a SIP[S] URI.

The sip_get_uri_query() function takes a parsed URI sip_uri and returns the value
of the 'query' component, if present.

The sip_get_uri_path() function takes a parsed URI sip_uri and returns the value
of the 'path' component, if present.

The sip_get_uri_regname() function takes a parsed URI sip_uri and returns the value
of the 'regname' component, if present.

The sip_is_uri_teluser() function returns B_TRUE if the user component is a telephone-subscriber.
Otherwise, B_FALSE is returned.

The sip_get_uri_errflags() function returns the error flags from a parsed URI sip_uri.
The returned value is a bitmask with the appropriate bit set when
the parser, sip_parse_uri(), encounters an error. The following are the possible error values
that could be set:

The sip_uri_errflags_to_str() function takes the error flags from a parsed URI sip_uri
and forms a string with all the error bits that are set.
For example, if SIP_URIERR_PASS and SIP_URIERR_PORT are set in a parsed URI sip_uri,
the sip_uri_errflags_to_str() function returns a string such as: