Enum EscapeError 

pub enum EscapeError {
    ContainsCrlf,
    ContainsNull,
    ContainsTab,
    ContainsNonPrintable(u8),
    OversizeForBoundary(usize),
}

Reasons HeaderEscapeGuard::header_value rejects a string.

Each variant names the exact byte class that triggered the rejection so the caller can build a useful 4xx / 500 response and the audit log gets a structured diagnostic, not a hand-formatted string. The byte payload on ContainsNonPrintable is the offending byte itself, useful for debug logs and for tests asserting the guard caught the right byte.

Variants

ContainsCrlf

Value contained CR (\r) or LF (\n).

ContainsNull

Value contained NUL (\0).

ContainsTab

Value contained HTAB (\t).

ContainsNonPrintable(u8)

Value contained another non-printable ASCII byte (0x01–0x08, 0x0B, 0x0C, 0x0E–0x1F, or 0x7F). The payload is the offending byte for diagnostic clarity.

OversizeForBoundary(usize)

Value exceeds MAX_HEADER_VALUE_BYTES. The payload is the observed length so the caller can include it in the error reply.

Trait Implementations

impl Clone for EscapeError

fn clone(&self) -> EscapeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EscapeError

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

Formats the value using the given formatter.

impl Display for EscapeError

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

Formats the value using the given formatter.

impl Error for EscapeError

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

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for EscapeError

impl Eq for EscapeError

impl StructuralPartialEq for EscapeError