Enum ValueRef 

pub enum ValueRef<'a> {
    String(NodeStr<'a>),
    Jid(JidRef<'a>),
}

A decoded attribute value that can be either a string or a structured JID. This avoids string allocation when decoding JID tokens - the JidRef is returned directly and only converted to a string when actually needed.

Variants

String(NodeStr<'a>)

Jid(JidRef<'a>)

Implementations

impl<'a> ValueRef<'a>

pub fn encode_value<W: ByteWriter>( &self, encoder: &mut Encoder<'_, W>, ) -> Result<()>

Encode this value directly to the binary encoder.

pub fn as_str(&self) -> Cow<'_, str>

String view of the value. Borrows from self.

• String variant: borrows the inner str — zero copy
• Jid variant: Cow::Owned — allocates only when needed

pub fn as_jid(&self) -> Option<&JidRef<'a>>

Get the value as a JidRef, if it’s a JID variant.

pub fn to_jid(&self) -> Option<Jid>

Convert to an owned Jid, parsing from string if necessary.

pub fn to_node_value(&self) -> NodeValue

Convert to an owned NodeValue, preserving the variant (JID stays JID).

Trait Implementations

impl<'a> Clone for ValueRef<'a>

fn clone(&self) -> ValueRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ValueRef<'a>

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

Formats the value using the given formatter.

impl<'a> Display for ValueRef<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for ValueRef<'a>

fn eq(&self, other: &ValueRef<'a>) -> 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<'yoke> Yokeable<'yoke> for ValueRef<'static>

type Output = ValueRef<'yoke>

This type MUST be Self with the 'static replaced with 'a, i.e. Self<'a>

fn transform(&'yoke self) -> &'yoke Self::Output

This method must cast self between &'a Self<'static> and &'a Self<'a>.

fn transform_owned(self) -> Self::Output

This method must cast self between Self<'static> and Self<'a>.

unsafe fn make(from: Self::Output) -> Self

This method can be used to cast away Self<'a>’s lifetime.

fn transform_mut<F>(&'yoke mut self, f: F)

where F: 'static + for<'_yoke> FnOnce(&'_yoke mut Self::Output),

This method must cast self between &'a mut Self<'static> and &'a mut Self<'a>, and pass it to f.

impl<'a> StructuralPartialEq for ValueRef<'a>