Struct ResponseHead 

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

A parsed response head, borrowed from the client connection’s buffer.

Examples

use http_net::{ClientConn, ClientEvent, Request};

let mut conn = ClientConn::new();
let mut out = Vec::new();
conn.send_request(&Request::get("/").header("host", "a"), &mut out).unwrap();
let _ = conn.feed(b"HTTP/1.1 404 Not Found\r\nContent-Length: 0\r\n\r\n");
let ClientEvent::Response(resp) = conn.poll().unwrap() else { panic!() };
assert_eq!(resp.status(), 404);
assert_eq!(resp.reason(), "Not Found");

Implementations

impl<'a> ResponseHead<'a>

pub fn status(&self) -> u16

The status code (100..=599).

Examples

assert_eq!(resp.status(), 200);

pub fn reason(&self) -> &'a str

The reason phrase, if it is UTF-8 (it carries no meaning; RFC 9112 tells clients to ignore it).

Examples

assert_eq!(resp.reason(), "");

pub fn version(&self) -> Version

The protocol version.

Examples

assert_eq!(resp.version(), Version::Http10);

pub fn headers(&self) -> Headers<'a>

All fields in arrival order.

Examples

assert_eq!(resp.headers().count(), 2);

pub fn header(&self, name: &str) -> Option<&'a [u8]>

The value of the first field named name (ASCII case-insensitive).

Examples

assert_eq!(resp.header("content-type"), Some(&b"text/plain"[..]));

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

Like header, but only when the value is UTF-8.

Examples

assert_eq!(resp.header_str("server"), Some("x"));

pub fn framing(&self) -> BodyFraming

How the response body is delimited (accounts for HEAD requests and bodiless status codes).

Examples

assert_eq!(resp.framing(), BodyFraming::UntilClose);

pub fn keep_alive(&self) -> bool

Whether the connection can carry another request after this response.

Examples

assert!(resp.keep_alive());

Trait Implementations

impl<'a> Clone for ResponseHead<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ResponseHead<'a>

impl Debug for ResponseHead<'_>

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

Formats the value using the given formatter.