Struct sval::Label

pub struct Label<'computed> { /* private fields */ }

A textual label for some value.

Implementations

impl<'computed> Label<'computed>

pub fn to_owned(&self) -> Label<'static>

Create an owned label from this one.

This method will allocate if the label isn’t based on a static string.

impl Label<'static>

pub fn new_owned(label: String) -> Self

Create a new label from an owned string value.

impl<'computed> Label<'computed>

pub const fn new(label: &'static str) -> Self

Create a new label from a static string value.

For labels that can’t satisfy the 'static lifetime, use Label::new_computed. For labels that need owned values, use Label::new_owned.

pub const fn new_computed(label: &'computed str) -> Self

Create a new label from a string value borrowed for the 'computed lifetime.

pub const fn as_str(&self) -> &str

Get the value of the label as a string.

pub const fn as_static_str(&self) -> Option<&'static str>

Try get the value of the label as a static string.

For labels that were created over computed data this method will return None.

pub const fn with_tag(self, tag: &Tag) -> Self

Associate a tag as a hint with this label.

Tags don’t contribute to equality or ordering of labels but streams may use the them when interpreting the label value.

pub const fn tag(&self) -> Option<&Tag>

Get the tag hint associated with the label, if present.

Streams may use the tag when interpreting the label value.

pub fn try_to_owned(&self) -> Result<Label<'static>>

Try create an owned label from this one.

This method will always return Ok if the alloc feature is enabled. If the alloc feature is not enabled then this method will only return Ok if the underlying value is already 'static.

Trait Implementations

impl<'a> Borrow<str> for Label<'a>

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl<'computed> Clone for Label<'computed>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Label<'a>

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

Formats the value using the given formatter.

impl<'a> Hash for Label<'a>

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<'a, 'b> PartialEq<Label<'b>> for Label<'a>

fn eq(&self, other: &Label<'b>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for Label<'a>

impl<'computed> Send for Label<'computed>

impl<'computed> Sync for Label<'computed>