Struct NameAddr 

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

👎Deprecated since 0.2.0:

name-addr is header-level grammar; use sip_header::SipHeaderAddr or parse the URI with sip_uri::Uri directly

A SIP name-addr: optional display name with a URI.

Parses the following forms:

• "Display Name" <sip:user@host>
• <sip:user@host>
• sip:user@host (bare URI, no display name)

Deprecated since 0.2.0, will be removed in 0.3.0.

The name-addr production (RFC 3261 §25.1) appears inside SIP header fields like From, To, Contact, and Refer-To, where it is followed by header-level parameters (;tag=, ;expires=, etc.). This type rejects those parameters, so it cannot round-trip real SIP header values.

Migration

• Full SIP header parsing: use SipHeaderAddr from the sip-header crate, which handles display names, URIs, and header-level parameters.
• URI only: parse directly with Uri.

Implementations

impl NameAddr

pub fn new(uri: Uri) -> Self

Create a new NameAddr with the given URI and no display name.

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

Set the display name.

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.

Trait Implementations

impl Clone for NameAddr

fn clone(&self) -> NameAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NameAddr

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

Formats the value using the given formatter.

impl Display for NameAddr

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

Formats the value using the given formatter.

impl FromStr for NameAddr

type Err = ParseNameAddrError

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 NameAddr

fn eq(&self, other: &NameAddr) -> 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 Eq for NameAddr

impl StructuralPartialEq for NameAddr