Struct HttpResponse 

pub struct HttpResponse {
    pub status: StatusCode,
    pub reason: Option<String>,
    pub headers: HeaderMap<HeaderValue>,
}

Parsed HTTP response with status line and headers.

Contains the status-line and header section of an HTTP response (RFC 9110 §6). The message body is handled separately via streaming.

Fields

status: StatusCode

HTTP status code (e.g., 200, 404, 502).

reason: Option<String>

Reason phrase from the status line, if present.

headers: HeaderMap<HeaderValue>

Header fields from the response.

Implementations

impl HttpResponse

pub fn reason(&self) -> &str

Returns the reason phrase, falling back to the canonical phrase for the status code.

pub fn status_line(&self) -> String

Formats an HTTP/1.1 status line (e.g., HTTP/1.1 200 OK\r\n).

pub fn parse(buf: &[u8]) -> Result<Option<Self>>

Parses a response from a buffer and returns None when incomplete.

pub fn parse_with_len(buf: &[u8]) -> Result<Option<(usize, Self)>>

Parses a response from a buffer and returns None when incomplete.

Returns the length of the header section and the response.

pub async fn peek(reader: &mut impl Prebufferable) -> Result<(usize, Self)>

Reads and parses the response status line and header section.

Does not remove the header section from reader. Returns io::ErrorKind::OutOfMemory if the header section exceeds the buffer limit.

pub async fn read(reader: &mut impl Prebufferable) -> Result<Self>

Reads and parses the response status line and header section.

Removes the header section from the reader.

Trait Implementations

impl Debug for HttpResponse

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

Formats the value using the given formatter.