Enum Method 

#[non_exhaustive]
pub enum Method {
    Get,
    Head,
    Post,
    Put,
    Delete,
    Connect,
    Options,
    Trace,
    Patch,
    Other,
}

The request method.

Methods are case-sensitive (RFC 9110 section 9.1): get is a different, unregistered method and parses as Method::Other. The exact text is always available from RequestHead::method_str. A variant is added only when an RFC registers the method.

Examples

use http_net::Method;

assert_eq!(Method::from_bytes(b"GET"), Method::Get);
assert_eq!(Method::from_bytes(b"get"), Method::Other);
assert_eq!(Method::Post.as_str(), Some("POST"));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Get

GET

Head

HEAD: the response carries headers but never a body.

Post

POST

Put

PUT

Delete

DELETE

Connect

CONNECT: the target is in authority form; a 2xx response turns the connection into a tunnel.

Options

OPTIONS: the only method that may use the * target.

Trace

TRACE

Patch

PATCH

Other

Any other token.

Implementations

impl Method

pub fn from_bytes(token: &[u8]) -> Self

Classifies a method token (case-sensitive).

Examples

assert_eq!(http_net::Method::from_bytes(b"PATCH"), http_net::Method::Patch);

pub const fn as_str(&self) -> Option<&'static str>

The method’s text, or None for Method::Other.

Examples

assert_eq!(http_net::Method::Other.as_str(), None);

pub const fn is_safe(&self) -> bool

Whether the method is safe (RFC 9110 section 9.2.1): GET, HEAD, OPTIONS, TRACE. Method::Other is not; decide from the text.

Examples

use http_net::Method;

assert!(Method::Head.is_safe());
assert!(!Method::Put.is_safe());

pub const fn is_idempotent(&self) -> bool

Whether the method is idempotent (RFC 9110 section 9.2.2): the safe methods plus PUT and DELETE.

Examples

use http_net::Method;

assert!(Method::Delete.is_idempotent());
assert!(!Method::Post.is_idempotent());

pub const fn index(&self) -> u8

A dense index, 0..=9 in declaration order (Other is 9), for bit sets and lookup tables.

Examples

use http_net::Method;

assert_eq!(Method::Get.index(), 0);
assert_eq!(Method::Other.index(), 9);

Trait Implementations

impl Clone for Method

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Method

impl Debug for Method

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

Formats the value using the given formatter.

impl Eq for Method

impl Hash for Method

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 PartialEq for Method

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Method