Struct PPreferredIdentity 

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

One strict P-Preferred-Identity value (RFC 3325 §9.2).

PPreferredIdentityList is the complete construction and receive-list API.

Implementations

impl PPreferredIdentity

pub fn new(address: Address) -> Result<Self, HeaderError>

Construct one strict RFC 3325 value from a parsed address.

Only SIP, SIPS and TEL are accepted, and RFC 8217’s name-addr rule is enforced. Use the checked complete-list type when constructing a whole field.

pub fn address(&self) -> &Address

The parsed identity address.

pub fn to_bytes(&self) -> Bytes

Serialize this identity as an unambiguous name-address value.

Methods from Deref<Target = Address>

pub fn param(&self, name: &str) -> Option<&[u8]>

The value of a header parameter.

pub fn tag(&self) -> Option<&[u8]>

The tag parameter, which identifies a dialog participant.

Trait Implementations

impl Clone for PPreferredIdentity

fn clone(&self) -> PPreferredIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PPreferredIdentity

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

Formats the value using the given formatter.

impl Deref for PPreferredIdentity

type Target = Address

The resulting type after dereferencing.

fn deref(&self) -> &Address

Dereferences the value.

impl TypedHeader for PPreferredIdentity

const NAME: HeaderName = HeaderName::PPreferredIdentity

The header this type reads.

const VALIDATE_LIST: bool = true

Whether Headers::typed_all must collect and validate the complete field before yielding.

fn decode(value: &[u8]) -> Result<Self, HeaderError>

Parse one header value. The value arrives unfolded and trimmed.

fn decode_list(value: &[u8]) -> Result<Vec<Self>, HeaderError>

Parse every value in one header row.

fn validate_list(values: &[&Self]) -> Result<(), HeaderError>

Validate all decoded values of this field across the complete message.