Struct FormErrors 

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

Available on crate feature alloc only.

Every problem with one submitted form, for showing the form again with a message beside each field: what FromForm::from_body_all returns.

A parse error (a malformed body, a limit) stops the parse, so it is the only error; extraction errors are collected for every field, at most one per received value plus one per missing field. No value is ever kept.

Examples

use form_net::{ExtractError, FromForm};

form_net::form! {
    #[derive(Debug)]
    pub struct Signup { pub email: String, pub age: u8, pub tos: bool }
}

let errors = Signup::from_body_all(b"application/x-www-form-urlencoded", b"age=300&role=admin").unwrap_err();
assert_eq!(errors.len(), 3);
assert_eq!(errors.field("age"), Some(ExtractError::Invalid("out of range")));
assert_eq!(errors.field("email"), Some(ExtractError::Missing));
assert_eq!(errors.unknown(), 1);
assert_eq!(errors.status_hint(), 422);

Implementations

impl FormErrors

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

Every error, in the order found.

pub fn len(&self) -> usize

How many errors.

pub fn is_empty(&self) -> bool

Whether there are none (never true for a returned value).

pub fn first(&self) -> Option<&FormError>

The first error.

pub fn field(&self, name: &str) -> Option<ExtractError>

The first extraction error for the field with this Rust name.

pub fn unknown(&self) -> usize

How many received names the struct neither declares nor ignores.

pub fn status_hint(&self) -> u16

The status hint of the first error (422 for extraction errors).

Trait Implementations

impl Clone for FormErrors

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FormErrors

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

Formats the value using the given formatter.

impl Display for FormErrors

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

Formats the value using the given formatter.

impl Eq for FormErrors

impl Error for FormErrors

Available on crate feature std only.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<FormError> for FormErrors

fn from(e: FormError) -> FormErrors

Converts to this type from the input type.

impl PartialEq for FormErrors

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FormErrors