Struct MetadataKey

pub struct MetadataKey<VE>
where
    VE: ValueEncoding,
{ /* private fields */ }

Represents a custom metadata field name.

MetadataKey is used as the MetadataMap key.

Implementations

impl<VE> MetadataKey<VE>

where VE: ValueEncoding,

pub fn from_bytes(src: &[u8]) -> Result<MetadataKey<VE>, InvalidMetadataKey>

Converts a slice of bytes to a MetadataKey.

This function normalizes the input.

pub fn from_static(src: &'static str) -> MetadataKey<VE>

Converts a static string to a MetadataKey.

This function panics when the static string is a invalid metadata key.

This function requires the static string to only contain lowercase characters, numerals and symbols, as per the HTTP/2.0 specification and header names internal representation within this library.

Examples

// Parsing a metadata key
let CUSTOM_KEY: &'static str = "custom-key";

let a = AsciiMetadataKey::from_bytes(b"custom-key").unwrap();
let b = AsciiMetadataKey::from_static(CUSTOM_KEY);
assert_eq!(a, b);

// Parsing a metadata key that contains invalid symbols(s):
AsciiMetadataKey::from_static("content{}{}length"); // This line panics!

// Parsing a metadata key that contains invalid uppercase characters.
let a = AsciiMetadataKey::from_static("foobar");
let b = AsciiMetadataKey::from_static("FOOBAR"); // This line panics!

// Parsing a -bin metadata key as an Ascii key.
let b = AsciiMetadataKey::from_static("hello-bin"); // This line panics!

// Parsing a non-bin metadata key as an Binary key.
let b = BinaryMetadataKey::from_static("hello"); // This line panics!

pub fn as_str(&self) -> &str

Returns a str representation of the metadata key.

The returned string will always be lower case.

Trait Implementations

impl<VE> AsRef<[u8]> for MetadataKey<VE>

where VE: ValueEncoding,

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<VE> AsRef<str> for MetadataKey<VE>

where VE: ValueEncoding,

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl<VE> Borrow<str> for MetadataKey<VE>

where VE: ValueEncoding,

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl<VE> Clone for MetadataKey<VE>

where VE: Clone + ValueEncoding,

fn clone(&self) -> MetadataKey<VE>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<VE> Debug for MetadataKey<VE>

where VE: ValueEncoding,

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

Formats the value using the given formatter.

impl<VE> Display for MetadataKey<VE>

where VE: ValueEncoding,

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

Formats the value using the given formatter.

impl<'a, VE> From<&'a MetadataKey<VE>> for MetadataKey<VE>

where VE: ValueEncoding,

fn from(src: &'a MetadataKey<VE>) -> MetadataKey<VE>

Converts to this type from the input type.

impl<KeyVE> From<MetadataKey<KeyVE>> for MetadataValue<Ascii>

where KeyVE: ValueEncoding,

fn from(h: MetadataKey<KeyVE>) -> MetadataValue<Ascii>

Converts to this type from the input type.

impl<VE> FromStr for MetadataKey<VE>

where VE: ValueEncoding,

type Err = InvalidMetadataKey

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<MetadataKey<VE>, InvalidMetadataKey>

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

impl<VE> Hash for MetadataKey<VE>

where VE: Hash + ValueEncoding,

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

where __H: Hasher,

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, VE> PartialEq<&'a MetadataKey<VE>> for MetadataKey<VE>

where VE: ValueEncoding,

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

where VE: ValueEncoding,

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

Performs a case-insensitive comparison of the string against the header name

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, VE> PartialEq<MetadataKey<VE>> for &'a MetadataKey<VE>

where VE: ValueEncoding,

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

where VE: ValueEncoding,

fn eq(&self, other: &MetadataKey<VE>) -> bool

Performs a case-insensitive comparison of the string against the header name

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<VE> PartialEq<MetadataKey<VE>> for str

where VE: ValueEncoding,

fn eq(&self, other: &MetadataKey<VE>) -> bool

Performs a case-insensitive comparison of the string against the header name

Examples

let content_length = AsciiMetadataKey::from_static("content-length");

assert_eq!(content_length, "content-length");
assert_eq!(content_length, "Content-Length");
assert_ne!(content_length, "content length");

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<VE> PartialEq<str> for MetadataKey<VE>

where VE: ValueEncoding,

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

Performs a case-insensitive comparison of the string against the header name

Examples

let content_length = AsciiMetadataKey::from_static("content-length");

assert_eq!(content_length, "content-length");
assert_eq!(content_length, "Content-Length");
assert_ne!(content_length, "content length");

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<VE> PartialEq for MetadataKey<VE>

where VE: PartialEq + ValueEncoding,

fn eq(&self, other: &MetadataKey<VE>) -> 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<VE> Eq for MetadataKey<VE>

where VE: Eq + ValueEncoding,

impl<VE> StructuralPartialEq for MetadataKey<VE>

where VE: ValueEncoding,