Module headers 

Zero-copy header types for efficient header processing.

This module provides header types that avoid allocation in the hot path by using borrowed references and Cow for deferred cloning.

Performance

• Header iteration: O(n) with zero allocations
• Header lookup: O(1) average (borrowed from source HashMap)
• Conversion to owned: Only allocates when actually needed
• SmallVec for values: Inline storage for single-value headers (most common)

Modules

names

Common HTTP header names as constants (avoids string allocation).

Structs

HeaderIterator

Header name/value iterator that yields references.

HeadersCow

Copy-on-write headers for deferred cloning.

HeadersRef

Zero-copy header reference.

Functions

from_cow_optimized

Convert Cow-optimized headers back to standard format.

from_optimized

Convert optimized headers back to standard format.

intern_header_name

Intern a header name, returning a static reference for known headers.

iter_flat

Iterate over headers yielding (name, value) pairs without allocation.

iter_flat_cow

Iterate over Cow headers yielding (name, value) pairs.

iter_flat_optimized

Iterate over optimized headers yielding (name, value) pairs.

to_cow_optimized

Convert standard headers to Cow-optimized format.

to_optimized

Convert standard headers to optimized format.

Type Aliases

CowHeaderMap

Header map using Cow<’static, str> keys for zero-allocation header names.

CowHeaderName

Header name type using Cow for zero-allocation on common headers.

HeaderValues

Header values using SmallVec for inline storage.

OptimizedHeaderMap

Optimized header map using SmallVec for values.