Struct UriInfo 

pub struct UriInfo(/* private fields */);

Parsed <absoluteURI> *(SEMI generic-param) header value.

Used by Call-Info, Alert-Info, and Error-Info. Contains one or more entries.

use sip_header::UriInfo;

let raw = "<urn:example:call:123>;purpose=emergency-CallId,<https://example.com/data>;purpose=EmergencyCallData.ServiceInfo";
let info = UriInfo::parse(raw).unwrap();
assert_eq!(info.entries().len(), 2);
assert_eq!(info.entries()[0].purpose(), Some("emergency-CallId"));

Implementations

impl UriInfo

pub fn parse(raw: &str) -> Result<UriInfo, UriInfoError>

Parse a comma-separated <absoluteURI> *(SEMI generic-param) value.

pub fn from_entries<'a>( entries: impl IntoIterator<Item = &'a str>, ) -> Result<UriInfo, UriInfoError>

Build from pre-split header entries.

Each entry should be a single <uri>;param=value string. Use this when entries have already been split by an external mechanism (e.g. a transport-specific array encoding).

Malformed entries are skipped per RFC 3261 §7.5 error recovery. Returns Err(Empty) only when all entries fail to parse.

pub fn entries(&self) -> &[UriInfoEntry]

The parsed entries as a slice.

pub fn into_entries(self) -> Vec<UriInfoEntry>

Consume self and return the entries as a Vec.

pub fn len(&self) -> usize

Number of entries.

pub fn is_empty(&self) -> bool

Returns true if there are no entries.

Trait Implementations

impl Clone for UriInfo

fn clone(&self) -> UriInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UriInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for UriInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for UriInfo

impl<'a> IntoIterator for &'a UriInfo

type Item = &'a UriInfoEntry

The type of the elements being iterated over.

type IntoIter = Iter<'a, UriInfoEntry>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a UriInfo as IntoIterator>::IntoIter

Creates an iterator from a value.

impl IntoIterator for UriInfo

type Item = UriInfoEntry

The type of the elements being iterated over.

type IntoIter = IntoIter<UriInfoEntry>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <UriInfo as IntoIterator>::IntoIter

Creates an iterator from a value.

impl PartialEq for UriInfo

fn eq(&self, other: &UriInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for UriInfo