Struct SipHeaderAddr 

#[non_exhaustive]
pub struct SipHeaderAddr { /* private fields */ }

Parsed SIP name-addr (RFC 3261 §25.1) with header-level parameters.

The name-addr production from RFC 3261 §25.1 combines an optional display name with a URI in angle brackets:

name-addr      = [ display-name ] LAQUOT addr-spec RAQUOT
display-name   = *(token LWS) / quoted-string

In SIP headers (From, To, Contact, P-Asserted-Identity, Refer-To), the name-addr is followed by header-level parameters (RFC 3261 §20):

from-spec  = ( name-addr / addr-spec ) *( SEMI from-param )
from-param = tag-param / generic-param

This type handles the full production including those trailing parameters (;tag=, ;expires=, ;serviceurn=, etc.).

Unlike sip_uri::NameAddr (which only handles the name-addr portion), this type also parses header-level parameters after > and can round-trip real SIP header values.

use sip_header::SipHeaderAddr;

let addr: SipHeaderAddr = r#""Alice" <sip:alice@example.com>;tag=abc123"#.parse().unwrap();
assert_eq!(addr.display_name(), Some("Alice"));
assert_eq!(addr.tag(), Some("abc123"));

Display always emits angle brackets around the URI, even for bare addr-spec input. This is the canonical form required by RFC 3261 when header-level parameters are present.

Implementations

impl SipHeaderAddr

pub fn new(uri: Uri) -> Self

Create a new SipHeaderAddr with the given URI and no display name or params.

pub fn with_display_name(self, name: impl Into<String>) -> Self

Set the display name.

pub fn with_param( self, key: impl Into<String>, value: Option<impl Into<String>>, ) -> Self

Add a header-level parameter. The key is lowercased on insertion.

pub fn display_name(&self) -> Option<&str>

The display name, if present.

pub fn uri(&self) -> &Uri

The URI.

pub fn sip_uri(&self) -> Option<&SipUri>

If the URI is a SIP/SIPS URI, return a reference to it.

pub fn tel_uri(&self) -> Option<&TelUri>

If the URI is a tel: URI, return a reference to it.

pub fn urn_uri(&self) -> Option<&UrnUri>

If the URI is a URN, return a reference to it.

pub fn params(&self) -> impl Iterator<Item = (&str, Option<&str>)>

Iterator over header-level parameters as (key, raw_value) pairs. Keys are lowercased; values retain their original percent-encoding.

Header-level parameter names (after >) are RFC 3261 §25 generic-param tokens, where % is a literal character — names are never percent-decoded here. URI parameters inside <…> are the opposite: sip_uri decodes their names. The same feature tag therefore keys as +urn%3aemergency%3a… in this list but +urn:emergency:… as a URI parameter.

pub fn param( &self, name: &str, ) -> Option<Result<Option<Cow<'_, str>>, Utf8Error>>

Look up a header-level parameter by name (case-insensitive).

The name is matched against the raw token from the wire — parameter names are not percent-decoded (see params()), so a percent-encoded name must be looked up in its encoded form.

Values are percent-decoded and validated as UTF-8. Returns Err if the percent-decoded octets are not valid UTF-8. For non-UTF-8 values or raw wire access, use param_raw().

Returns None if the param is not present, Some(Ok(None)) for flag params (no value), Some(Ok(Some(decoded))) for valued params.

pub fn param_raw(&self, name: &str) -> Option<Option<&str>>

Look up a raw percent-encoded parameter value (case-insensitive).

Returns the raw value without percent-decoding. Use this when round-trip fidelity matters or the value may not be valid UTF-8.

pub fn replaces(&self) -> Option<Result<SipReplaces, SipReplacesError>>

Parse a Replaces URI header (<sip:…?Replaces=…>), if present.

Returns None when the URI is not a SIP/SIPS URI or carries no Replaces header; Some(Err) when the value doesn’t conform to RFC 3891 §6.1.

pub fn parse_list( raw: &str, ) -> Result<Vec<SipHeaderAddr>, ParseSipHeaderAddrError>

Parse a comma-separated list of name-addr / addr-spec values.

Splits on commas at bracket depth zero (via split_comma_entries), then parses each entry as a SipHeaderAddr. Returns an empty Vec for empty input. Fails on the first unparseable entry.

pub fn tag(&self) -> Option<&str>

The tag parameter value, if present.

Tag values are simple tokens (never percent-encoded in practice), so this returns &str directly.

Trait Implementations

impl Clone for SipHeaderAddr

fn clone(&self) -> SipHeaderAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SipHeaderAddr

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

Formats the value using the given formatter.

impl Display for SipHeaderAddr

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

Formats the value using the given formatter.

impl Eq for SipHeaderAddr

impl FromStr for SipHeaderAddr

type Err = ParseSipHeaderAddrError

The associated error which can be returned from parsing.

fn from_str(input: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for SipHeaderAddr

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SipHeaderAddr