Struct opentelemetry::baggage::Baggage [−][src]
pub struct Baggage { /* fields omitted */ }
A set of name-value pairs describing user-defined properties.
Baggage Names
- ASCII strings according to the token format, defined in RFC2616, Section 2.2
Baggage Values
- URL encoded UTF-8 strings.
Baggage Value Metadata
Additional metadata can be added to values in the form of a property set,
represented as semi-colon ;
delimited list of names and/or name-value pairs,
e.g. ;k1=v1;k2;k3=v3
.
Limits
- Maximum number of name-value pairs:
180
. - Maximum number of bytes per a single name-value pair:
4096
. - Maximum total length of all name-value pairs:
8192
.
Implementations
impl Baggage
[src]
impl Baggage
[src]pub fn get<T: Into<Key>>(&self, key: T) -> Option<&Value>
[src]
pub fn get<T: Into<Key>>(&self, key: T) -> Option<&Value>
[src]Returns a reference to the value associated with a given name
Examples
use opentelemetry::{baggage::Baggage, Value}; let mut cc = Baggage::new(); let _ = cc.insert("my-name", "my-value"); assert_eq!(cc.get("my-name"), Some(&Value::from("my-value")))
pub fn get_with_metadata<T: Into<Key>>(
&self,
key: T
) -> Option<&(Value, BaggageMetadata)>
[src]
pub fn get_with_metadata<T: Into<Key>>(
&self,
key: T
) -> Option<&(Value, BaggageMetadata)>
[src]Returns a reference to the value and metadata associated with a given name
Examples
use opentelemetry::{baggage::{Baggage, BaggageMetadata}, Value}; let mut cc = Baggage::new(); let _ = cc.insert("my-name", "my-value"); // By default, the metadata is empty assert_eq!(cc.get_with_metadata("my-name"), Some(&(Value::from("my-value"), BaggageMetadata::from(""))))
pub fn insert<K, V>(&mut self, key: K, value: V) -> Option<Value> where
K: Into<Key>,
V: Into<Value>,
[src]
pub fn insert<K, V>(&mut self, key: K, value: V) -> Option<Value> where
K: Into<Key>,
V: Into<Value>,
[src]Inserts a name-value pair into the baggage.
If the name was not present, None
is returned. If the name was present,
the value is updated, and the old value is returned.
Examples
use opentelemetry::{baggage::Baggage, Value}; let mut cc = Baggage::new(); let _ = cc.insert("my-name", "my-value"); assert_eq!(cc.get("my-name"), Some(&Value::from("my-value")))
pub fn insert_with_metadata<K, V, S>(
&mut self,
key: K,
value: V,
metadata: S
) -> Option<(Value, BaggageMetadata)> where
K: Into<Key>,
V: Into<Value>,
S: Into<BaggageMetadata>,
[src]
pub fn insert_with_metadata<K, V, S>(
&mut self,
key: K,
value: V,
metadata: S
) -> Option<(Value, BaggageMetadata)> where
K: Into<Key>,
V: Into<Value>,
S: Into<BaggageMetadata>,
[src]Inserts a name-value pair into the baggage.
Same with insert
, if the name was not present, None
will be returned.
If the name is present, the old value and metadata will be returned.
Examples
use opentelemetry::{baggage::{Baggage, BaggageMetadata}, Value}; let mut cc = Baggage::new(); let _ = cc.insert_with_metadata("my-name", "my-value", "test"); assert_eq!(cc.get_with_metadata("my-name"), Some(&(Value::from("my-value"), BaggageMetadata::from("test"))))
Trait Implementations
impl FromIterator<(Key, (Value, BaggageMetadata))> for Baggage
[src]
impl FromIterator<(Key, (Value, BaggageMetadata))> for Baggage
[src]impl FromIterator<KeyValue> for Baggage
[src]
impl FromIterator<KeyValue> for Baggage
[src]fn from_iter<I: IntoIterator<Item = KeyValue>>(iter: I) -> Self
[src]
fn from_iter<I: IntoIterator<Item = KeyValue>>(iter: I) -> Self
[src]Creates a value from an iterator. Read more
impl FromIterator<KeyValueMetadata> for Baggage
[src]
impl FromIterator<KeyValueMetadata> for Baggage
[src]fn from_iter<I: IntoIterator<Item = KeyValueMetadata>>(iter: I) -> Self
[src]
fn from_iter<I: IntoIterator<Item = KeyValueMetadata>>(iter: I) -> Self
[src]Creates a value from an iterator. Read more
Auto Trait Implementations
impl RefUnwindSafe for Baggage
impl Send for Baggage
impl Sync for Baggage
impl Unpin for Baggage
impl UnwindSafe for Baggage
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,