Struct RawHead 

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

The bytes of a head and the spans of its parts, all relative to bytes: what RequestHead::raw and ResponseHead::raw return.

The bytes run from the first byte the connection kept for the message (any empty lines a client sent before the request line, which RFC 9112 section 2.2 lets a server skip, are included) to the end of the blank line that ends the head. Spans for parts a head does not have are empty: status on a request, method and target on a response.

Debug shows lengths and spans only, never the bytes, so a raw head in a log cannot leak a credential.

Examples

use http_net::{ServerConn, ServerEvent};

let mut conn = ServerConn::new();
let _ = conn.feed(b"GET /a HTTP/1.1\r\nHost: x\r\n\r\nbody bytes are not part of it");
let ServerEvent::Request(req) = conn.poll().unwrap() else { panic!() };
let raw = req.raw();
assert_eq!(raw.bytes(), b"GET /a HTTP/1.1\r\nHost: x\r\n\r\n");
assert_eq!(raw.method().get(raw.bytes()), b"GET");
assert_eq!(raw.target().get(raw.bytes()), b"/a");
assert_eq!(raw.version().get(raw.bytes()), b"HTTP/1.1");
assert!(raw.status().is_empty());
assert_eq!(raw.fields().len(), 1);

Implementations

impl<'a> RawHead<'a>

pub fn bytes(&self) -> &'a [u8]

The head bytes, from its first byte to the end of the blank line.

Examples

See RawHead.

pub fn start_line(&self) -> Span

The request line or status line, without its CRLF.

Examples

let raw = req.raw();
assert_eq!(raw.start_line().get(raw.bytes()), b"GET / HTTP/1.1");

pub fn method(&self) -> Span

The method (requests; empty for a response).

Examples

See RawHead.

pub fn target(&self) -> Span

The request target (requests; empty for a response).

Examples

See RawHead.

pub fn version(&self) -> Span

The protocol version, HTTP/1.1 or HTTP/1.0 as received.

Examples

See RawHead.

pub fn status(&self) -> Span

The three status digits (responses; empty for a request).

Examples

let raw = resp.raw();
assert_eq!(raw.status().get(raw.bytes()), b"404");
assert!(raw.method().is_empty());

pub fn fields(&self) -> &'a [FieldSpan]

Every field line’s name and value spans, in arrival order.

Examples

See FieldSpan.

Trait Implementations

impl<'a> Clone for RawHead<'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 RawHead<'a>

impl Debug for RawHead<'_>

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

Formats the value using the given formatter.