[−][src]Struct http::header::HeaderValue
Represents an HTTP header field value.
In practice, HTTP header field values are usually valid ASCII. However, the HTTP spec allows for a header value to contain opaque bytes as well. In this case, the header field value is not able to be represented as a string.
To handle this, the HeaderValue
is useable as a type and can be compared
with strings and implements Debug
. A to_str
fn is provided that returns
an Err
if the header value contains non visible ascii characters.
Methods
impl HeaderValue
[src]
pub fn from_static(src: &'static str) -> HeaderValue
[src]
Convert a static string to a HeaderValue
.
This function will not perform any copying, however the string is checked to ensure that no invalid characters are present. Only visible ASCII characters (32-127) are permitted.
Panics
This function panics if the argument contains invalid header value characters.
Examples
let val = HeaderValue::from_static("hello"); assert_eq!(val, "hello");
pub fn from_str(src: &str) -> Result<HeaderValue, InvalidHeaderValue>
[src]
Attempt to convert a string to a HeaderValue
.
If the argument contains invalid header value characters, an error is
returned. Only visible ASCII characters (32-127) are permitted. Use
from_bytes
to create a HeaderValue
that includes opaque octets
(128-255).
This function is intended to be replaced in the future by a TryFrom
implementation once the trait is stabilized in std.
Examples
let val = HeaderValue::from_str("hello").unwrap(); assert_eq!(val, "hello");
An invalid value
let val = HeaderValue::from_str("\n"); assert!(val.is_err());
pub fn from_name(name: HeaderName) -> HeaderValue
[src]
Converts a HeaderName into a HeaderValue
Since every valid HeaderName is a valid HeaderValue this is done infallibly.
Examples
let val = HeaderValue::from_name(ACCEPT); assert_eq!(val, HeaderValue::from_bytes(b"accept").unwrap());
pub fn from_bytes(src: &[u8]) -> Result<HeaderValue, InvalidHeaderValue>
[src]
Attempt to convert a byte slice to a HeaderValue
.
If the argument contains invalid header value bytes, an error is returned. Only byte values between 32 and 255 (inclusive) are permitted, excluding byte 127 (DEL).
This function is intended to be replaced in the future by a TryFrom
implementation once the trait is stabilized in std.
Examples
let val = HeaderValue::from_bytes(b"hello\xfa").unwrap(); assert_eq!(val, &b"hello\xfa"[..]);
An invalid value
let val = HeaderValue::from_bytes(b"\n"); assert!(val.is_err());
pub fn from_shared(src: Bytes) -> Result<HeaderValue, InvalidHeaderValueBytes>
[src]
Attempt to convert a Bytes
buffer to a HeaderValue
.
If the argument contains invalid header value bytes, an error is returned. Only byte values between 32 and 255 (inclusive) are permitted, excluding byte 127 (DEL).
This function is intended to be replaced in the future by a TryFrom
implementation once the trait is stabilized in std.
pub unsafe fn from_shared_unchecked(src: Bytes) -> HeaderValue
[src]
Convert a Bytes
directly into a HeaderValue
without validating.
This function does NOT validate that illegal bytes are not contained within the buffer.
pub fn to_str(&self) -> Result<&str, ToStrError>
[src]
Yields a &str
slice if the HeaderValue
only contains visible ASCII
chars.
This function will perform a scan of the header value, checking all the characters.
Examples
let val = HeaderValue::from_static("hello"); assert_eq!(val.to_str().unwrap(), "hello");
pub fn len(&self) -> usize
[src]
Returns the length of self
.
This length is in bytes.
Examples
let val = HeaderValue::from_static("hello"); assert_eq!(val.len(), 5);
pub fn is_empty(&self) -> bool
[src]
Returns true if the HeaderValue
has a length of zero bytes.
Examples
let val = HeaderValue::from_static(""); assert!(val.is_empty()); let val = HeaderValue::from_static("hello"); assert!(!val.is_empty());
pub fn as_bytes(&self) -> &[u8]
[src]
Converts a HeaderValue
to a byte slice.
Examples
let val = HeaderValue::from_static("hello"); assert_eq!(val.as_bytes(), b"hello");
pub fn set_sensitive(&mut self, val: bool)
[src]
Mark that the header value represents sensitive information.
Examples
let mut val = HeaderValue::from_static("my secret"); val.set_sensitive(true); assert!(val.is_sensitive()); val.set_sensitive(false); assert!(!val.is_sensitive());
pub fn is_sensitive(&self) -> bool
[src]
Returns true
if the value represents sensitive data.
Sensitive data could represent passwords or other data that should not
be stored on disk or in memory. This setting can be used by components
like caches to avoid storing the value. HPACK encoders must set the
header field to never index when is_sensitive
returns true.
Note that sensitivity is not factored into equality or ordering.
Examples
let mut val = HeaderValue::from_static("my secret"); val.set_sensitive(true); assert!(val.is_sensitive()); val.set_sensitive(false); assert!(!val.is_sensitive());
Trait Implementations
impl HttpTryFrom<u16> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: u16) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<i16> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: i16) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<u32> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: u32) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<i32> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: i32) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<u64> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: u64) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<i64> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: i64) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<usize> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: usize) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<isize> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(num: isize) -> Result<Self, Self::Error>
[src]
impl<'a> HttpTryFrom<&'a HeaderValue> for HeaderValue
[src]
type Error = Never
Associated error with the conversion this implementation represents.
fn try_from(t: &'a HeaderValue) -> Result<Self, Self::Error>
[src]
impl<'a> HttpTryFrom<&'a str> for HeaderValue
[src]
type Error = InvalidHeaderValue
Associated error with the conversion this implementation represents.
fn try_from(t: &'a str) -> Result<Self, Self::Error>
[src]
impl<'a> HttpTryFrom<&'a [u8]> for HeaderValue
[src]
type Error = InvalidHeaderValue
Associated error with the conversion this implementation represents.
fn try_from(t: &'a [u8]) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<String> for HeaderValue
[src]
type Error = InvalidHeaderValueBytes
Associated error with the conversion this implementation represents.
fn try_from(t: String) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<Bytes> for HeaderValue
[src]
type Error = InvalidHeaderValueBytes
Associated error with the conversion this implementation represents.
fn try_from(bytes: Bytes) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<HeaderName> for HeaderValue
[src]
type Error = InvalidHeaderValue
Associated error with the conversion this implementation represents.
fn try_from(name: HeaderName) -> Result<Self, Self::Error>
[src]
impl HttpTryFrom<HeaderValue> for HeaderValue
[src]
type Error = Error
Associated error with the conversion this implementation represents.
fn try_from(t: Self) -> Result<Self, Self::Error>
[src]
impl Clone for HeaderValue
[src]
fn clone(&self) -> HeaderValue
[src]
default fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Ord for HeaderValue
[src]
fn cmp(&self, other: &Self) -> Ordering
[src]
default fn max(self, other: Self) -> Self
1.21.0[src]
Compares and returns the maximum of two values. Read more
default fn min(self, other: Self) -> Self
1.21.0[src]
Compares and returns the minimum of two values. Read more
default fn clamp(self, min: Self, max: Self) -> Self
[src]
clamp
)Restrict a value to a certain interval. Read more
impl Eq for HeaderValue
[src]
impl PartialOrd<HeaderValue> for HeaderValue
[src]
fn partial_cmp(&self, other: &HeaderValue) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialOrd<str> for HeaderValue
[src]
fn partial_cmp(&self, other: &str) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialOrd<[u8]> for HeaderValue
[src]
fn partial_cmp(&self, other: &[u8]) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialOrd<HeaderValue> for str
[src]
fn partial_cmp(&self, other: &HeaderValue) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialOrd<HeaderValue> for [u8]
[src]
fn partial_cmp(&self, other: &HeaderValue) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialOrd<String> for HeaderValue
[src]
fn partial_cmp(&self, other: &String) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialOrd<HeaderValue> for String
[src]
fn partial_cmp(&self, other: &HeaderValue) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl<'a> PartialOrd<HeaderValue> for &'a HeaderValue
[src]
fn partial_cmp(&self, other: &HeaderValue) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl<'a, T: ?Sized> PartialOrd<&'a T> for HeaderValue where
HeaderValue: PartialOrd<T>,
[src]
HeaderValue: PartialOrd<T>,
fn partial_cmp(&self, other: &&'a T) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl<'a> PartialOrd<HeaderValue> for &'a str
[src]
fn partial_cmp(&self, other: &HeaderValue) -> Option<Ordering>
[src]
#[must_use]
default fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]
default fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
#[must_use]
default fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
#[must_use]
default fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl PartialEq<HeaderValue> for HeaderValue
[src]
fn eq(&self, other: &HeaderValue) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl PartialEq<str> for HeaderValue
[src]
fn eq(&self, other: &str) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl PartialEq<[u8]> for HeaderValue
[src]
fn eq(&self, other: &[u8]) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl PartialEq<HeaderValue> for str
[src]
fn eq(&self, other: &HeaderValue) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl PartialEq<HeaderValue> for [u8]
[src]
fn eq(&self, other: &HeaderValue) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl PartialEq<String> for HeaderValue
[src]
fn eq(&self, other: &String) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl PartialEq<HeaderValue> for String
[src]
fn eq(&self, other: &HeaderValue) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl<'a> PartialEq<HeaderValue> for &'a HeaderValue
[src]
fn eq(&self, other: &HeaderValue) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl<'a, T: ?Sized> PartialEq<&'a T> for HeaderValue where
HeaderValue: PartialEq<T>,
[src]
HeaderValue: PartialEq<T>,
fn eq(&self, other: &&'a T) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl<'a> PartialEq<HeaderValue> for &'a str
[src]
fn eq(&self, other: &HeaderValue) -> bool
[src]
#[must_use]
default fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl AsRef<[u8]> for HeaderValue
[src]
impl From<HeaderName> for HeaderValue
[src]
fn from(h: HeaderName) -> HeaderValue
[src]
impl From<u16> for HeaderValue
[src]
fn from(num: u16) -> HeaderValue
[src]
impl From<i16> for HeaderValue
[src]
fn from(num: i16) -> HeaderValue
[src]
impl From<u32> for HeaderValue
[src]
fn from(num: u32) -> HeaderValue
[src]
impl From<i32> for HeaderValue
[src]
fn from(num: i32) -> HeaderValue
[src]
impl From<u64> for HeaderValue
[src]
fn from(num: u64) -> HeaderValue
[src]
impl From<i64> for HeaderValue
[src]
fn from(num: i64) -> HeaderValue
[src]
impl From<usize> for HeaderValue
[src]
fn from(num: usize) -> HeaderValue
[src]
impl From<isize> for HeaderValue
[src]
fn from(num: isize) -> HeaderValue
[src]
impl From<HeaderValue> for Bytes
[src]
fn from(value: HeaderValue) -> Bytes
[src]
impl<'a> From<&'a HeaderValue> for HeaderValue
[src]
fn from(t: &'a HeaderValue) -> Self
[src]
impl Debug for HeaderValue
[src]
impl Hash for HeaderValue
[src]
fn hash<__H: Hasher>(&self, state: &mut __H)
[src]
default fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl FromStr for HeaderValue
[src]
type Err = InvalidHeaderValue
The associated error which can be returned from parsing.
fn from_str(s: &str) -> Result<HeaderValue, Self::Err>
[src]
Auto Trait Implementations
impl Send for HeaderValue
impl Sync for HeaderValue
Blanket Implementations
impl<T, U> Into for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
impl<T> From for T
[src]
impl<T, U> TryFrom for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T> Borrow for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,