Struct PAssertedIdentityList 

pub struct PAssertedIdentityList { /* private fields */ }

A complete identity field: strict for construction, tolerant and explicit on receive.

Implementations

impl PAssertedIdentityList

pub fn new( values: impl IntoIterator<Item = PAssertedIdentity>, ) -> Result<Self, HeaderError>

Construct a complete RFC 3325 field, enforcing its one-or-two-value invariant.

pub fn from_headers(headers: &Headers) -> Result<Option<Self>, HeaderError>

Decode all received rows in wire order using RFC 5876 §4.5 filtering.

Ok(None) means the field is absent. Unexpected schemes, duplicate schemes and a SIP/SIPS combination are not syntax errors: they appear in Self::ignored. A forwarding proxy must remove those indexed values before sending the request; applying several removals in descending index order keeps earlier indices stable.

pub fn values(&self) -> &[PAssertedIdentity]

Values that may be used and forwarded, in their received or construction order.

pub fn ignored(&self) -> &[IgnoredIdentity]

Values RFC 5876 says to ignore and not forward, with stable wire-order indices.

Remove several values from Headers in reverse order so each remaining index still refers to the field shape this report describes.

pub fn requires_rewrite(&self) -> bool

Whether forwarding the original field unchanged would violate RFC 5876 §4.5.

pub fn into_parts(self) -> (Vec<PAssertedIdentity>, Vec<IgnoredIdentity>)

Consume the list and return the usable values plus the ignored-value report.

pub fn to_bytes(&self) -> Option<Bytes>

Serialize the usable values as one deterministic comma-and-space-delimited row.

Ignored received values are deliberately absent: RFC 5876 forbids forwarding them. None means every received value was ignored, so a proxy removes the field rather than constructing an invalid empty row.

Trait Implementations

impl Clone for PAssertedIdentityList

fn clone(&self) -> PAssertedIdentityList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PAssertedIdentityList

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

Formats the value using the given formatter.