Enum HeaderName 

pub enum HeaderName {
    Host,
    ContentType,
    ContentLength,
    ContentEncoding,
    TransferEncoding,
    Connection,
    Accept,
    AcceptEncoding,
    Authorization,
    UserAgent,
    CacheControl,
    Location,
    Date,
    Server,
    Cookie,
    SetCookie,
    Traceparent,
    Tracestate,
    Baggage,
    Custom(Bytes),
}

An HTTP header name. A name we already know is a unit variant that resolves to a 'static canonical (lowercase) byte string — zero allocation, integer compare. An unknown name carries its bytes in HeaderName::Custom.

HeaderName implements IntoHeaderBytes, so headers.insert(HeaderName:: ContentLength, ..) stores Bytes::from_static(b"content-length") with no copy — the outbound construction win — while HeaderList keeps its Bytes storage and case-insensitive &str lookups unchanged. HTTP names are case-insensitive, so from_bytes matches any casing and canonicalizes to the lowercase static form (what get’s eq_ignore_ascii_case already finds).

Variants

Host

ContentType

ContentLength

ContentEncoding

TransferEncoding

Connection

Accept

AcceptEncoding

Authorization

UserAgent

CacheControl

Location

Date

Server

Cookie

SetCookie

Traceparent

Tracestate

Baggage

Custom(Bytes)

A non-standard header name, holding its bytes.

Implementations

impl HeaderName

pub fn from_bytes(bytes: &[u8]) -> Self

Classify raw bytes case-insensitively. A known name returns a unit variant (no allocation); an unknown name copies into Custom.

pub fn from_wire(bytes: Bytes) -> Self

Take ownership of wire Bytes: a known name drops the bytes and returns a unit variant; an unknown name keeps the bytes zero-copy in Custom.

pub fn as_bytes(&self) -> &[u8]

The canonical lowercase wire bytes. Known names return a 'static slice; Custom returns its carried bytes. No allocation.

pub fn to_bytes(&self) -> Bytes

The name as Bytes for storage/wire. Known names are Bytes::from_static (zero allocation); Custom clones its Bytes (a refcount bump).

pub fn as_str(&self) -> Option<&str>

The name as &str (always valid UTF-8 for known names).

Trait Implementations

impl Clone for HeaderName

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 HeaderName

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

Formats the value using the given formatter.

impl Eq for HeaderName

impl From<&[u8]> for HeaderName

fn from(bytes: &[u8]) -> Self

Converts to this type from the input type.

impl From<&str> for HeaderName

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<Bytes> for HeaderName

fn from(bytes: Bytes) -> Self

Converts to this type from the input type.

impl IntoHeaderBytes for HeaderName

Available on crate feature alloc only.

fn into_header_bytes(self) -> Bytes

impl PartialEq for HeaderName

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HeaderName