Struct HttpResponseHead 

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

Available on crate feature http only.

📡 ⇄ HTTP response head.

---

^{📍 sys/net/http}

---

Represents an HTTP status line and basic representation headers.

The current encoder writes the textual HTTP/1 wire format.

Implementations

impl<'a> HttpResponseHead<'a>

pub const fn new(status: HttpStatus) -> Self

Creates an HTTP/1.1 response head with the given status.

pub const fn ok() -> Self

Creates a 200 OK HTTP/1.1 response head.

pub const fn not_found() -> Self

Creates a 404 Not Found HTTP/1.1 response head.

pub const fn with_version(self, version: HttpVersion) -> Self

Sets the HTTP version.

pub const fn with_content_type(self, content_type: &'a str) -> Self

Sets the Content-Type header.

The value is validated when the response head is encoded.

pub const fn with_content_length(self, len: usize) -> Self

Sets the Content-Length header.

pub const fn version(self) -> HttpVersion

Returns the HTTP version.

pub const fn status(self) -> HttpStatus

Returns the response status.

pub const fn content_type(self) -> Option<&'a str>

Returns the Content-Type value, when set.

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

Returns the Content-Length value, when set.

pub const fn http1_encoded_len(self) -> Result<usize, HttpError>

Returns the encoded HTTP/1 response-head length.

Returns an error when the configured version has no HTTP/1 textual representation or a configured header value is invalid.

pub const fn write_http1_into(self, dst: &mut [u8]) -> Result<usize, HttpError>

Writes the textual HTTP/1 response head into dst.

Returns the number of bytes written.

The operation is atomic: if an error is returned, dst is unchanged.

Trait Implementations

impl<'a> Clone for HttpResponseHead<'a>

fn clone(&self) -> HttpResponseHead<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for HttpResponseHead<'a>

impl<'a> Debug for HttpResponseHead<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for HttpResponseHead<'a>

impl<'a> Hash for HttpResponseHead<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for HttpResponseHead<'a>

fn eq(&self, other: &HttpResponseHead<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> StructuralPartialEq for HttpResponseHead<'a>