Enum DuplicatePolicy 

#[non_exhaustive]
pub enum DuplicatePolicy {
    Refuse,
    First,
    Last,
}

What a parameter parser does when a name repeats.

Names compare ASCII case-insensitively. Refuse, the default, fails with ErrorKind::DuplicateParameter at the repeated name: a field one component reads first-wins and another last-wins is a known attack. First and Last exist for fields whose RFC states the rule. Structured Fields always use last-wins, as RFC 9651 requires.

Examples

use parse_net::{param, DuplicatePolicy, Limits};

let limits = Limits::DEFAULT.duplicate_params(DuplicatePolicy::Last);
let (p, _) = param::parse(b";a=1;a=2", &limits)?;
assert!(p.get("a").is_some_and(|v| v.eq_bytes(b"2")));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Refuse

Refuse a repeated name.

First

Keep the first occurrence for lookups.

Last

Keep the last occurrence for lookups.

Trait Implementations

impl Clone for DuplicatePolicy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DuplicatePolicy

impl Debug for DuplicatePolicy

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

Formats the value using the given formatter.

impl Default for DuplicatePolicy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for DuplicatePolicy

impl Hash for DuplicatePolicy

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 PartialEq for DuplicatePolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DuplicatePolicy