Struct StatusCode 

pub struct StatusCode { /* private fields */ }

An HTTP status code paired with its reason phrase.

Construct one of the common constants (e.g. StatusCode::OK) or build an arbitrary code with StatusCode::new.

Implementations

impl StatusCode

pub const fn new(code: u16, reason: &'static str) -> StatusCode

Build a status from a numeric code and reason phrase.

pub const fn code(self) -> u16

The numeric code, e.g. 200.

pub const fn reason(self) -> &'static str

The reason phrase, e.g. "OK".

pub const fn is_bodyless(self) -> bool

Whether the status forbids a message body (1xx, 204, 304).

impl StatusCode

Named constants for the status codes this crate uses. The names follow the RFC 9110 registry; see StatusCode::reason for the phrase.

pub const CONTINUE: StatusCode

pub const OK: StatusCode

pub const CREATED: StatusCode

pub const ACCEPTED: StatusCode

pub const NO_CONTENT: StatusCode

pub const PARTIAL_CONTENT: StatusCode

pub const MOVED_PERMANENTLY: StatusCode

pub const FOUND: StatusCode

pub const TEMPORARY_REDIRECT: StatusCode

pub const PERMANENT_REDIRECT: StatusCode

pub const NOT_MODIFIED: StatusCode

pub const BAD_REQUEST: StatusCode

pub const FORBIDDEN: StatusCode

pub const NOT_FOUND: StatusCode

pub const METHOD_NOT_ALLOWED: StatusCode

pub const LENGTH_REQUIRED: StatusCode

pub const PAYLOAD_TOO_LARGE: StatusCode

pub const RANGE_NOT_SATISFIABLE: StatusCode

pub const URI_TOO_LONG: StatusCode

pub const REQUEST_HEADER_FIELDS_TOO_LARGE: StatusCode

pub const INTERNAL_SERVER_ERROR: StatusCode

pub const NOT_IMPLEMENTED: StatusCode

pub const SERVICE_UNAVAILABLE: StatusCode

pub const HTTP_VERSION_NOT_SUPPORTED: StatusCode

Trait Implementations

impl Clone for StatusCode

fn clone(&self) -> StatusCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for StatusCode

impl Debug for StatusCode

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

Formats the value using the given formatter.

impl Eq for StatusCode

impl From<StatusCode> for StatusCode

fn from(s: StatusCode) -> Self

Converts to this type from the input type.

impl From<u16> for StatusCode

fn from(code: u16) -> StatusCode

Map a bare numeric code to a known reason phrase, falling back to a generic phrase for the class. The specific arms intentionally precede the class-range fallbacks.

impl IntoResponse for StatusCode

A bare status with an empty body.

fn into_response(self) -> Response

Consume self and produce the response to send.

impl PartialEq for StatusCode

fn eq(&self, other: &StatusCode) -> 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 StructuralPartialEq for StatusCode

impl TryFrom<StatusCode> for StatusCode

type Error = InvalidStatusCode

The type returned in the event of a conversion error.

fn try_from(s: StatusCode) -> Result<Self, Self::Error>

Performs the conversion.