Struct hyper::StatusCode[][src]

pub struct StatusCode(_);

An HTTP status code (status-code in RFC 7230 et al.).

This type contains constants for all common status codes. It allows status codes in the range [100, 599].

IANA maintain the Hypertext Transfer Protocol (HTTP) Status Code Registry which is the source for this enum (with one exception, 418 I'm a teapot, which is inexplicably not in the register).

Examples

use http::StatusCode;

assert_eq!(StatusCode::from_u16(200).unwrap(), StatusCode::OK);
assert_eq!(StatusCode::NOT_FOUND.as_u16(), 404);
assert!(StatusCode::OK.is_success());

Methods

impl StatusCode
[src]

Converts a u16 to a status code.

The function validates the correctness of the supplied u16. It must be greater or equal to 100 but less than 600.

Example

use http::StatusCode;

let ok = StatusCode::from_u16(200).unwrap();
assert_eq!(ok, StatusCode::OK);

let err = StatusCode::from_u16(99);
assert!(err.is_err());

Converts a &u8 to a status code

Returns the u16 corresponding to this StatusCode.

Note

This is the same as the From<StatusCode> implementation, but included as an inherent method because that implementation doesn't appear in rustdocs, as well as a way to force the type instead of relying on inference.

Example

let status = http::StatusCode::OK;
assert_eq!(status.as_u16(), 200);

Returns a &str representation of the StatusCode

The return value only includes a numerical representation of the status code. The canonical reason is not included.

Example

let status = http::StatusCode::OK;
assert_eq!(status.as_str(), "200");

Get the standardised reason-phrase for this status code.

This is mostly here for servers writing responses, but could potentially have application at other times.

The reason phrase is defined as being exclusively for human readers. You should avoid deriving any meaning from it at all costs.

Bear in mind also that in HTTP/2.0 the reason phrase is abolished from transmission, and so this canonical reason phrase really is the only reason phrase you’ll find.

Example

let status = http::StatusCode::OK;
assert_eq!(status.canonical_reason(), Some("OK"));

Check if status is within 100-199.

Check if status is within 200-299.

Check if status is within 300-399.

Check if status is within 400-499.

Check if status is within 500-599.

impl StatusCode
[src]

CONTINUE: StatusCode = StatusCode(100)

100 Continue [RFC7231, Section 6.2.1]

SWITCHING_PROTOCOLS: StatusCode = StatusCode(101)

101 Switching Protocols [RFC7231, Section 6.2.2]

PROCESSING: StatusCode = StatusCode(102)

102 Processing [RFC2518]

OK: StatusCode = StatusCode(200)

200 OK [RFC7231, Section 6.3.1]

CREATED: StatusCode = StatusCode(201)

201 Created [RFC7231, Section 6.3.2]

ACCEPTED: StatusCode = StatusCode(202)

202 Accepted [RFC7231, Section 6.3.3]

NON_AUTHORITATIVE_INFORMATION: StatusCode = StatusCode(203)

203 Non-Authoritative Information [RFC7231, Section 6.3.4]

NO_CONTENT: StatusCode = StatusCode(204)

204 No Content [RFC7231, Section 6.3.5]

RESET_CONTENT: StatusCode = StatusCode(205)

205 Reset Content [RFC7231, Section 6.3.6]

PARTIAL_CONTENT: StatusCode = StatusCode(206)

206 Partial Content [RFC7233, Section 4.1]

MULTI_STATUS: StatusCode = StatusCode(207)

207 Multi-Status [RFC4918]

ALREADY_REPORTED: StatusCode = StatusCode(208)

208 Already Reported [RFC5842]

IM_USED: StatusCode = StatusCode(226)

226 IM Used [RFC3229]

MULTIPLE_CHOICES: StatusCode = StatusCode(300)

300 Multiple Choices [RFC7231, Section 6.4.1]

MOVED_PERMANENTLY: StatusCode = StatusCode(301)

301 Moved Permanently [RFC7231, Section 6.4.2]

FOUND: StatusCode = StatusCode(302)

302 Found [RFC7231, Section 6.4.3]

SEE_OTHER: StatusCode = StatusCode(303)

303 See Other [RFC7231, Section 6.4.4]

NOT_MODIFIED: StatusCode = StatusCode(304)

304 Not Modified [RFC7232, Section 4.1]

USE_PROXY: StatusCode = StatusCode(305)

305 Use Proxy [RFC7231, Section 6.4.5]

TEMPORARY_REDIRECT: StatusCode = StatusCode(307)

307 Temporary Redirect [RFC7231, Section 6.4.7]

PERMANENT_REDIRECT: StatusCode = StatusCode(308)

308 Permanent Redirect [RFC7238]

BAD_REQUEST: StatusCode = StatusCode(400)

400 Bad Request [RFC7231, Section 6.5.1]

UNAUTHORIZED: StatusCode = StatusCode(401)

401 Unauthorized [RFC7235, Section 3.1]

PAYMENT_REQUIRED: StatusCode = StatusCode(402)

402 Payment Required [RFC7231, Section 6.5.2]

FORBIDDEN: StatusCode = StatusCode(403)

403 Forbidden [RFC7231, Section 6.5.3]

NOT_FOUND: StatusCode = StatusCode(404)

404 Not Found [RFC7231, Section 6.5.4]

METHOD_NOT_ALLOWED: StatusCode = StatusCode(405)

405 Method Not Allowed [RFC7231, Section 6.5.5]

NOT_ACCEPTABLE: StatusCode = StatusCode(406)

406 Not Acceptable [RFC7231, Section 6.5.6]

PROXY_AUTHENTICATION_REQUIRED: StatusCode = StatusCode(407)

407 Proxy Authentication Required [RFC7235, Section 3.2]

REQUEST_TIMEOUT: StatusCode = StatusCode(408)

408 Request Timeout [RFC7231, Section 6.5.7]

CONFLICT: StatusCode = StatusCode(409)

409 Conflict [RFC7231, Section 6.5.8]

GONE: StatusCode = StatusCode(410)

410 Gone [RFC7231, Section 6.5.9]

LENGTH_REQUIRED: StatusCode = StatusCode(411)

411 Length Required [RFC7231, Section 6.5.10]

PRECONDITION_FAILED: StatusCode = StatusCode(412)

412 Precondition Failed [RFC7232, Section 4.2]

PAYLOAD_TOO_LARGE: StatusCode = StatusCode(413)

413 Payload Too Large [RFC7231, Section 6.5.11]

URI_TOO_LONG: StatusCode = StatusCode(414)

414 URI Too Long [RFC7231, Section 6.5.12]

UNSUPPORTED_MEDIA_TYPE: StatusCode = StatusCode(415)

415 Unsupported Media Type [RFC7231, Section 6.5.13]

RANGE_NOT_SATISFIABLE: StatusCode = StatusCode(416)

416 Range Not Satisfiable [RFC7233, Section 4.4]

EXPECTATION_FAILED: StatusCode = StatusCode(417)

417 Expectation Failed [RFC7231, Section 6.5.14]

IM_A_TEAPOT: StatusCode = StatusCode(418)

418 I'm a teapot [curiously not registered by IANA but RFC2324]

MISDIRECTED_REQUEST: StatusCode = StatusCode(421)

421 Misdirected Request RFC7540, Section 9.1.2

UNPROCESSABLE_ENTITY: StatusCode = StatusCode(422)

422 Unprocessable Entity [RFC4918]

LOCKED: StatusCode = StatusCode(423)

423 Locked [RFC4918]

FAILED_DEPENDENCY: StatusCode = StatusCode(424)

424 Failed Dependency [RFC4918]

UPGRADE_REQUIRED: StatusCode = StatusCode(426)

426 Upgrade Required [RFC7231, Section 6.5.15]

PRECONDITION_REQUIRED: StatusCode = StatusCode(428)

428 Precondition Required [RFC6585]

TOO_MANY_REQUESTS: StatusCode = StatusCode(429)

429 Too Many Requests [RFC6585]

REQUEST_HEADER_FIELDS_TOO_LARGE: StatusCode = StatusCode(431)

431 Request Header Fields Too Large [RFC6585]

UNAVAILABLE_FOR_LEGAL_REASONS: StatusCode = StatusCode(451)

451 Unavailable For Legal Reasons [RFC7725]

INTERNAL_SERVER_ERROR: StatusCode = StatusCode(500)

500 Internal Server Error [RFC7231, Section 6.6.1]

NOT_IMPLEMENTED: StatusCode = StatusCode(501)

501 Not Implemented [RFC7231, Section 6.6.2]

BAD_GATEWAY: StatusCode = StatusCode(502)

502 Bad Gateway [RFC7231, Section 6.6.3]

SERVICE_UNAVAILABLE: StatusCode = StatusCode(503)

503 Service Unavailable [RFC7231, Section 6.6.4]

GATEWAY_TIMEOUT: StatusCode = StatusCode(504)

504 Gateway Timeout [RFC7231, Section 6.6.5]

HTTP_VERSION_NOT_SUPPORTED: StatusCode = StatusCode(505)

505 HTTP Version Not Supported [RFC7231, Section 6.6.6]

VARIANT_ALSO_NEGOTIATES: StatusCode = StatusCode(506)

506 Variant Also Negotiates [RFC2295]

INSUFFICIENT_STORAGE: StatusCode = StatusCode(507)

507 Insufficient Storage [RFC4918]

LOOP_DETECTED: StatusCode = StatusCode(508)

508 Loop Detected [RFC5842]

NOT_EXTENDED: StatusCode = StatusCode(510)

510 Not Extended [RFC2774]

NETWORK_AUTHENTICATION_REQUIRED: StatusCode = StatusCode(511)

511 Network Authentication Required [RFC6585]

Trait Implementations

impl PartialOrd<StatusCode> for StatusCode
[src]

This method returns an ordering between self and other values if one exists. Read more

This method tests less than (for self and other) and is used by the < operator. Read more

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

This method tests greater than (for self and other) and is used by the > operator. Read more

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl Hash for StatusCode
[src]

Feeds this value into the given [Hasher]. Read more

Feeds a slice of this type into the given [Hasher]. Read more

impl Clone for StatusCode
[src]

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

impl FromStr for StatusCode
[src]

The associated error which can be returned from parsing.

Parses a string s to return a value of this type. Read more

impl Debug for StatusCode
[src]

Formats the value using the given formatter. Read more

impl Ord for StatusCode
[src]

This method returns an Ordering between self and other. Read more

Compares and returns the maximum of two values. Read more

Compares and returns the minimum of two values. Read more

impl From<StatusCode> for u16
[src]

Performs the conversion.

impl<'a> From<&'a StatusCode> for StatusCode
[src]

Performs the conversion.

impl<'a> HttpTryFrom<&'a str> for StatusCode
[src]

Associated error with the conversion this implementation represents.

impl<'a> HttpTryFrom<&'a [u8]> for StatusCode
[src]

Associated error with the conversion this implementation represents.

impl HttpTryFrom<u16> for StatusCode
[src]

Associated error with the conversion this implementation represents.

impl HttpTryFrom<StatusCode> for StatusCode
[src]

Associated error with the conversion this implementation represents.

impl<'a> HttpTryFrom<&'a StatusCode> for StatusCode
[src]

Associated error with the conversion this implementation represents.

impl Display for StatusCode
[src]

Formats the status code, including the canonical reason.

Example

assert_eq!(format!("{}", StatusCode::OK), "200 OK");

Formats the value using the given formatter. Read more

impl Default for StatusCode
[src]

Returns the "default value" for a type. Read more

impl Copy for StatusCode
[src]

impl Eq for StatusCode
[src]

impl PartialEq<StatusCode> for u16
[src]

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

impl PartialEq<StatusCode> for StatusCode
[src]

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

impl PartialEq<u16> for StatusCode
[src]

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

Auto Trait Implementations

impl Send for StatusCode

impl Sync for StatusCode