Struct HeadersParser 

pub struct HeadersParser<'a> { /* private fields */ }

Parses headers and extracts Content-Length / Transfer-Encoding.

This is a zero-copy parser that yields headers while tracking the body length indicator.

Example

let buffer = b"Content-Length: 42\r\nHost: example.com\r\n\r\n";
let headers = HeadersParser::parse(buffer)?;

assert_eq!(headers.body_length(), BodyLength::ContentLength(42));
assert_eq!(headers.content_length(), Some(42));

Implementations

impl<'a> HeadersParser<'a>

pub fn parse(buffer: &'a [u8]) -> Result<Self, ParseError>

Parse all headers from a buffer.

Returns the parser with pre-computed Content-Length and Transfer-Encoding. The buffer should start at the first header line (after request line).

pub fn parse_with_limits( buffer: &'a [u8], limits: &ParseLimits, ) -> Result<Self, ParseError>

Parse all headers from a buffer with limits.

Enforces header count, line length, and total size limits. Also rejects ambiguous body length indicators (Transfer-Encoding + Content-Length).

pub fn body_length(&self) -> BodyLength

Returns the body length indicator.

Per RFC 7230:

• If Transfer-Encoding: chunked is present, use chunked decoding
• Else if Content-Length is present, use that
• Else no body

pub fn content_length(&self) -> Option<usize>

Returns the Content-Length value if present.

pub fn is_chunked(&self) -> bool

Returns true if Transfer-Encoding: chunked.

pub fn bytes_consumed(&self) -> usize

Returns the number of bytes consumed (including final \r\n\r\n).

pub fn iter(&self) -> HeadersIter<'a>

Returns an iterator over all headers.

pub fn get(&self, name: &str) -> Option<Header<'a>>

Finds a header by name (case-insensitive).

pub fn get_all<'b>( &'b self, name: &'b str, ) -> impl Iterator<Item = Header<'a>> + 'b

Returns all headers matching a name (case-insensitive).