[][src]Struct tonic::metadata::MetadataValue

#[repr(transparent)]pub struct MetadataValue<VE: ValueEncoding> { /* fields omitted */ }

Represents a custom metadata field value.

MetadataValue is used as the MetadataMap value.

Implementations

impl<VE: ValueEncoding> MetadataValue<VE>[src]

pub fn from_static(src: &'static str) -> Self[src]

Convert a static string to a MetadataValue.

This function will not perform any copying, however the string is checked to ensure that no invalid characters are present.

For Ascii values, only visible ASCII characters (32-127) are permitted. For Binary values, the string must be valid base64.

Panics

This function panics if the argument contains invalid metadata value characters.

Examples

let val = AsciiMetadataValue::from_static("hello");
assert_eq!(val, "hello");
let val = BinaryMetadataValue::from_static("SGVsbG8hIQ==");
assert_eq!(val, "Hello!!");

pub fn try_from_bytes(src: &[u8]) -> Result<Self, InvalidMetadataValueBytes>[src]

Attempt to convert a byte slice to a MetadataValue.

For Ascii metadata values, If the argument contains invalid metadata value bytes, an error is returned. Only byte values between 32 and 255 (inclusive) are permitted, excluding byte 127 (DEL).

For Binary metadata values this method cannot fail. See also the Binary only version of this method from_bytes.

This function is intended to be replaced in the future by a TryFrom implementation once the trait is stabilized in std.

Examples

let val = AsciiMetadataValue::try_from_bytes(b"hello\xfa").unwrap();
assert_eq!(val, &b"hello\xfa"[..]);

An invalid value

let val = AsciiMetadataValue::try_from_bytes(b"\n");
assert!(val.is_err());

pub fn from_shared(src: Bytes) -> Result<Self, InvalidMetadataValueBytes>[src]

Attempt to convert a Bytes buffer to a MetadataValue.

For MetadataValue<Ascii>, if the argument contains invalid metadata value bytes, an error is returned. Only byte values between 32 and 255 (inclusive) are permitted, excluding byte 127 (DEL).

For MetadataValue<Binary>, if the argument is not valid base64, an error is returned. In use cases where the input is not base64 encoded, use from_bytes; if the value has to be encoded it's not possible to share the memory anyways.

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) -> Self[src]

Convert a Bytes directly into a MetadataValue without validating. For MetadataValue the provided parameter must be base64 encoded without padding bytes at the end.

This function does NOT validate that illegal bytes are not contained within the buffer.

pub fn is_empty(&self) -> bool[src]

Returns true if the MetadataValue has a length of zero bytes.

Examples

let val = AsciiMetadataValue::from_static("");
assert!(val.is_empty());

let val = AsciiMetadataValue::from_static("hello");
assert!(!val.is_empty());

pub fn to_bytes(&self) -> Result<Bytes, InvalidMetadataValueBytes>[src]

Converts a MetadataValue to a Bytes buffer. This method cannot fail for Ascii values. For Ascii values, as_bytes is more convenient to use.

Examples

let val = AsciiMetadataValue::from_static("hello");
assert_eq!(val.to_bytes().unwrap().as_ref(), b"hello");
let val = BinaryMetadataValue::from_bytes(b"hello");
assert_eq!(val.to_bytes().unwrap().as_ref(), b"hello");

pub fn set_sensitive(&mut self, val: bool)[src]

Mark that the metadata value represents sensitive information.

Examples

let mut val = AsciiMetadataValue::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 metadata field to never index when is_sensitive returns true.

Note that sensitivity is not factored into equality or ordering.

Examples

let mut val = AsciiMetadataValue::from_static("my secret");

val.set_sensitive(true);
assert!(val.is_sensitive());

val.set_sensitive(false);
assert!(!val.is_sensitive());

pub fn as_encoded_bytes(&self) -> &[u8][src]

Converts a MetadataValue to a byte slice. For Binary values, the return value is base64 encoded.

Examples

let val = AsciiMetadataValue::from_static("hello");
assert_eq!(val.as_encoded_bytes(), b"hello");
let val = BinaryMetadataValue::from_bytes(b"Hello!");
assert_eq!(val.as_encoded_bytes(), b"SGVsbG8h");

impl MetadataValue<Ascii>[src]

pub fn from_str(src: &str) -> Result<Self, InvalidMetadataValue>[src]

Attempt to convert a string to a MetadataValue<Ascii>.

If the argument contains invalid metadata value characters, an error is returned. Only visible ASCII characters (32-127) are permitted. Use from_bytes to create a MetadataValue 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 = AsciiMetadataValue::from_str("hello").unwrap();
assert_eq!(val, "hello");

An invalid value

let val = AsciiMetadataValue::from_str("\n");
assert!(val.is_err());

pub fn from_key<KeyVE: ValueEncoding>(key: MetadataKey<KeyVE>) -> Self[src]

Converts a MetadataKey into a MetadataValue.

Since every valid MetadataKey is a valid MetadataValue this is done infallibly.

Examples

let val = AsciiMetadataValue::from_key::<Ascii>("accept".parse().unwrap());
assert_eq!(val, AsciiMetadataValue::try_from_bytes(b"accept").unwrap());

pub fn len(&self) -> usize[src]

Returns the length of self, in bytes.

This method is not available for MetadataValue because that cannot be implemented in constant time, which most people would probably expect. To get the length of MetadataValue, convert it to a Bytes value and measure its length.

Examples

let val = AsciiMetadataValue::from_static("hello");
assert_eq!(val.len(), 5);

pub fn to_str(&self) -> Result<&str, ToStrError>[src]

Yields a &str slice if the MetadataValue only contains visible ASCII chars.

This function will perform a scan of the metadata value, checking all the characters.

Examples

let val = AsciiMetadataValue::from_static("hello");
assert_eq!(val.to_str().unwrap(), "hello");

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

Converts a MetadataValue to a byte slice. For Binary values, use to_bytes.

Examples

let val = AsciiMetadataValue::from_static("hello");
assert_eq!(val.as_bytes(), b"hello");

impl MetadataValue<Binary>[src]

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

Convert a byte slice to a MetadataValue<Binary>.

Examples

let val = BinaryMetadataValue::from_bytes(b"hello\xfa");
assert_eq!(val, &b"hello\xfa"[..]);

Trait Implementations

impl<VE: ValueEncoding> AsRef<[u8]> for MetadataValue<VE>[src]

impl<VE: Clone + ValueEncoding> Clone for MetadataValue<VE>[src]

impl<VE: ValueEncoding> Debug for MetadataValue<VE>[src]

impl<VE: ValueEncoding> Eq for MetadataValue<VE>[src]

impl<'a, VE: ValueEncoding> From<&'a MetadataValue<VE>> for MetadataValue<VE>[src]

impl<KeyVE: ValueEncoding> From<MetadataKey<KeyVE>> for MetadataValue<Ascii>[src]

impl<VE: ValueEncoding> From<MetadataValue<VE>> for Bytes[src]

impl From<i16> for MetadataValue<Ascii>[src]

impl From<i32> for MetadataValue<Ascii>[src]

impl From<i64> for MetadataValue<Ascii>[src]

impl From<isize> for MetadataValue<Ascii>[src]

impl From<u16> for MetadataValue<Ascii>[src]

impl From<u32> for MetadataValue<Ascii>[src]

impl From<u64> for MetadataValue<Ascii>[src]

impl From<usize> for MetadataValue<Ascii>[src]

impl FromStr for MetadataValue<Ascii>[src]

type Err = InvalidMetadataValue

The associated error which can be returned from parsing.

impl<VE: Hash + ValueEncoding> Hash for MetadataValue<VE>[src]

impl<VE: ValueEncoding> Ord for MetadataValue<VE>[src]

impl<'a, VE: ValueEncoding, T: ?Sized> PartialEq<&'a T> for MetadataValue<VE> where
    MetadataValue<VE>: PartialEq<T>, 
[src]

impl<VE: ValueEncoding> PartialEq<[u8]> for MetadataValue<VE>[src]

impl<VE: ValueEncoding> PartialEq<MetadataValue<VE>> for MetadataValue<VE>[src]

impl<VE: ValueEncoding> PartialEq<MetadataValue<VE>> for str[src]

impl<VE: ValueEncoding> PartialEq<MetadataValue<VE>> for [u8][src]

impl<VE: ValueEncoding> PartialEq<MetadataValue<VE>> for String[src]

impl<'a, VE: ValueEncoding> PartialEq<MetadataValue<VE>> for &'a MetadataValue<VE>[src]

impl<'a, VE: ValueEncoding> PartialEq<MetadataValue<VE>> for &'a str[src]

impl<VE: ValueEncoding> PartialEq<String> for MetadataValue<VE>[src]

impl<VE: ValueEncoding> PartialEq<str> for MetadataValue<VE>[src]

impl<'a, VE: ValueEncoding, T: ?Sized> PartialOrd<&'a T> for MetadataValue<VE> where
    MetadataValue<VE>: PartialOrd<T>, 
[src]

impl<VE: ValueEncoding> PartialOrd<[u8]> for MetadataValue<VE>[src]

impl<VE: ValueEncoding> PartialOrd<MetadataValue<VE>> for MetadataValue<VE>[src]

impl<VE: ValueEncoding> PartialOrd<MetadataValue<VE>> for str[src]

impl<VE: ValueEncoding> PartialOrd<MetadataValue<VE>> for [u8][src]

impl<VE: ValueEncoding> PartialOrd<MetadataValue<VE>> for String[src]

impl<'a, VE: ValueEncoding> PartialOrd<MetadataValue<VE>> for &'a MetadataValue<VE>[src]

impl<'a, VE: ValueEncoding> PartialOrd<MetadataValue<VE>> for &'a str[src]

impl<VE: ValueEncoding> PartialOrd<String> for MetadataValue<VE>[src]

impl<VE: ValueEncoding> PartialOrd<str> for MetadataValue<VE>[src]

Auto Trait Implementations

impl<VE> RefUnwindSafe for MetadataValue<VE> where
    VE: RefUnwindSafe

impl<VE> Send for MetadataValue<VE> where
    VE: Send

impl<VE> Sync for MetadataValue<VE> where
    VE: Sync

impl<VE> Unpin for MetadataValue<VE> where
    VE: Unpin

impl<VE> UnwindSafe for MetadataValue<VE> where
    VE: UnwindSafe

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<Q, K> Equivalent<K> for Q where
    K: Borrow<Q> + ?Sized,
    Q: Eq + ?Sized
[src]

impl<T> From<T> for T[src]

impl<T> Instrument for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 

impl<T> WithSubscriber for T[src]