Struct Method 

pub struct Method(/* private fields */);

HTTP メソッド (RFC 9110 Section 9.1, method = token)

case-sensitive (RFC 9110 Section 9.1 “The method token is case-sensitive”)。 Eq/Hash も case-sensitive。

構築経路

用途	API	不正 token 時
builder ('static リテラル)	TryFrom<&'static str> / TryFrom<&'static [u8]>	Err(MethodError)
動的入力	Method::new()	Err(MethodError)
const 定数 (compile-time 拒否)	Method::from_static(b"...")	コンパイル時 panic

非 'static な &str について

TryFrom<&'static str> のみ実装しているため、非 'static な &str は コンパイルエラーになる。動的な文字列を使う場合は Method::new() で 構築した値を渡すこと。

use shiguredo_http11::Method;

fn make_method(m: &str) -> Method {
    m.try_into().unwrap() // コンパイルエラー: &str は &'static str ではない
}

Implementations

impl Method

pub const GET: Self

標準メソッド定数

pub const POST: Self

pub const PUT: Self

pub const DELETE: Self

pub const HEAD: Self

pub const OPTIONS: Self

pub const CONNECT: Self

pub const TRACE: Self

pub const PATCH: Self

pub fn new(method: impl AsRef<[u8]>) -> Result<Self, MethodError>

ランタイム検査つきで構築する

pub const fn from_static(method: &'static [u8]) -> Self

コンパイル時検査つきで構築する

不正な入力はコンパイル時に panic する。 リテラル定数の構築に使用する。

正常系

use shiguredo_http11::Method;

const GET: Method = Method::from_static(b"GET");
const POST: Method = Method::from_static(b"POST");
const CUSTOM: Method = Method::from_static(b"WebDAV-MOVE");

不正リテラルの compile-fail 例

空のメソッドは不正:

const _: shiguredo_http11::Method =
    shiguredo_http11::Method::from_static(b"");

CR を含むメソッドは不正:

const _: shiguredo_http11::Method =
    shiguredo_http11::Method::from_static(b"GET\r");

LF を含むメソッドは不正:

const _: shiguredo_http11::Method =
    shiguredo_http11::Method::from_static(b"GET\n");

pub fn as_bytes(&self) -> &[u8]

内部バイト列を返す

pub fn as_str(&self) -> &str

文字列として返す (全 tchar は ASCII のため安全)

Trait Implementations

impl Clone for Method

fn clone(&self) -> Method

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Method

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

Formats the value using the given formatter.

impl Display for Method

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

Formats the value using the given formatter.

impl From<Method> for String

fn from(method: Method) -> Self

Converts to this type from the input type.

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<&str> for Method

fn eq(&self, other: &&str) -> 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 PartialEq<Method> for str

fn eq(&self, other: &Method) -> 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 PartialEq<str> for Method

fn eq(&self, other: &str) -> 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 PartialEq for Method

fn eq(&self, other: &Method) -> 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 TryFrom<&'static [u8]> for Method

type Error = MethodError

The type returned in the event of a conversion error.

fn try_from(bytes: &'static [u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'static str> for Method

type Error = MethodError

The type returned in the event of a conversion error.

fn try_from(s: &'static str) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Method

impl StructuralPartialEq for Method