Enum Outcome 

#[non_exhaustive]
pub enum Outcome {
    Chosen {
        index: usize,
        weight: QValue,
    },
    NoneAcceptable,
    HeaderIgnored {
        index: usize,
    },
    Refused(ParseError),
}

The result of a selection.

Examples

use parse_net::{negotiate::{Negotiator, Outcome}, QValue};

let n = Negotiator::new();
assert_eq!(n.media(Some(b"text/html"), &["text/html"]), Outcome::Chosen { index: 0, weight: QValue::ONE });
assert_eq!(n.media(Some(b"image/png"), &["text/html"]), Outcome::NoneAcceptable);
assert_eq!(n.media(Some(b"text/html;q=9"), &["text/html"]).index(), Some(0));

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.

Chosen

The offer at index is the best, with this weight.

Fields

index: usize

The index into the offers.

weight: QValue

Its weight.

NoneAcceptable

No offer is acceptable: answer 406, or send a default.

HeaderIgnored

The header did not parse and was treated as absent; the offer at index (the first) is chosen.

Fields

index: usize

The index into the offers.

Refused(ParseError)

The header did not parse, and the policy is to refuse it.

Implementations

impl Outcome

pub const fn index(&self) -> Option<usize>

The chosen offer, if any.

Examples

use parse_net::negotiate::Negotiator;

let n = Negotiator::new();
assert_eq!(n.encoding(Some(b"gzip"), &["br", "gzip"]).index(), Some(1));
assert_eq!(n.encoding(Some(b"gzip"), &["br"]).index(), None);

Trait Implementations

impl Clone for Outcome

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 Outcome

impl Debug for Outcome

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

Formats the value using the given formatter.

impl Eq for Outcome

impl Hash for Outcome

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 Outcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Outcome