Struct SipCallId 

pub struct SipCallId<'a> { /* private fields */ }

A Call-ID value, split on the one @ its grammar admits.

callid = word [ "@" word ] (RFC 3261 section 25.1). @ is not a word character, so the split is unambiguous and a second @ makes the value invalid rather than choosing a side.

host returns the second word, which section 8.1.1.4 leaves optional and does not require to be a hostname. Callers that need one parse it themselves; a value that carries something else is still a valid Call-ID.

use sip_header::SipCallId;

let id = SipCallId::parse("a84b4c76e66710@example.com")?;
assert_eq!(id.local(), "a84b4c76e66710");
assert_eq!(id.host(), Some("example.com"));

let bare = SipCallId::parse("f81d4fae7dec11d0a76500a0c91e6bf6")?;
assert_eq!(bare.host(), None);

Implementations

impl<'a> SipCallId<'a>

pub fn parse(raw: &'a str) -> Result<Self, SipCallIdError>

Parse a Call-ID header value.

Errors on an empty word or a character outside word — including a second @, whitespace, and the separators that would let a value carry a parameter or a second header line.

pub fn as_str(&self) -> &'a str

The value as parsed.

Call-IDs are compared byte-by-byte (RFC 3261 section 8.1.1.4), so this is the form to compare and to hash.

pub fn local(&self) -> &'a str

The first word — everything before the @, or the whole value.

pub fn host(&self) -> Option<&'a str>

The second word, if the value carries one.

Trait Implementations

impl<'a> Clone for SipCallId<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for SipCallId<'a>

impl<'a> Debug for SipCallId<'a>

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

Formats the value using the given formatter.

impl Display for SipCallId<'_>

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

Formats the value using the given formatter.

impl<'a> Eq for SipCallId<'a>

impl<'a> Hash for SipCallId<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for SipCallId<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for SipCallId<'a>