Struct RecipientList 

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

A validated batch of recipients enforcing both PCS quotas and SDK invariants:

• Non-empty: at least one recipient (PCS rejects empty batches).
• At most 1,000: PCS External API limit per send request.
• Deduplicated by ppnum: avoids paying for two deliveries to the same recipient if the caller’s caller passed dupes.

Construct via Self::try_new; the only unchecked path is From<Vec<Recipient>> which is intentionally not provided.

Implementations

impl RecipientList

pub fn try_new(recipients: Vec<Recipient>) -> Result<Self, RecipientListError>

Validate and dedupe a recipient batch.

Dedup is by Ppnum equality, preserving first-occurrence order. The deduped count must be in 1..=1000.

Errors

Returns RecipientListError::Empty when the input is empty, RecipientListError::TooLarge when the deduped result still exceeds 1,000 entries.

pub fn from_ppnums(ppnums: Vec<Ppnum>) -> Result<Self, RecipientListError>

Convenience constructor for the common case where only ppnums are needed and templates require no per-recipient variables.

Errors

Same as Self::try_new.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> impl Iterator<Item = &Recipient>

Iterate over the underlying recipients (read-only — invariants stay locked).

Trait Implementations

impl Clone for RecipientList

fn clone(&self) -> RecipientList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecipientList

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

Formats the value using the given formatter.

impl<'a> IntoIterator for &'a RecipientList

type Item = &'a Recipient

The type of the elements being iterated over.

type IntoIter = Iter<'a, Recipient>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.