Enum WriteError 

#[non_exhaustive]
pub enum WriteError {
    Full,
    Forbidden {
        at: u32,
    },
    OutOfRange,
    NotToken,
    InvalidSequence,
}

Why a writer refused.

Examples

use parse_net::{write, SliceSink, WriteError};

let mut buf = [0u8; 64];
let mut out = SliceSink::new(&mut buf);
let err = write::write_field_value(b"evil\r\nSet-Cookie: x=1", &mut out).unwrap_err();
assert_eq!(err, WriteError::Forbidden { at: 4 });
assert!(out.written().is_empty());

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.

Full

The sink has no room. When the sink reports its room (as SliceSink does), nothing was written. Retry with a larger buffer; CountSink gives the exact length.

Forbidden

The input byte at offset at is not allowed in the output grammar (CR, LF, NUL, another control, or a byte the format forbids). Refuse the input; never strip it and retry silently.

Fields

at: u32

Offset of the refused byte in the input.

OutOfRange

A number outside the format’s range.

NotToken

A position that requires a token got something else.

InvalidSequence

A structured writer was called out of order, such as a parameter before any item. A bug in the calling code.

Trait Implementations

impl Clone for WriteError

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 WriteError

impl Debug for WriteError

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

Formats the value using the given formatter.

impl Display for WriteError

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

Formats the value using the given formatter.

impl Eq for WriteError

impl Error for WriteError

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<Full> for WriteError

fn from(_: Full) -> Self

Converts to this type from the input type.

impl Hash for WriteError

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 WriteError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WriteError