Struct IcalValueNode 

pub struct IcalValueNode<'a> {
    pub escaper: Escaper,
    /* private fields */
}

Available on crate feature parser only.

A raw value: ;-separated components, each a list of ,-separated raw value leaves.

From parse the value is held as one unsplit raw slice and walked lazily, so a parse that never decodes and a byte-faithful reserialize do no splitting at all. The first edit (or a model encode) splits it into owned components, which then take over as the source of truth. The escaper records which version’s escaping rules the codec must apply; it is stamped from the card version after parsing (see IcalCst::parse).

Fields

escaper: Escaper

The escaping rules to read and write this value with.

Implementations

impl<'a> IcalValueNode<'a>

pub fn parse(value: &'a [u8]) -> Self

Wrap a raw value, unsplit and borrowed, to be walked lazily. The colon, name and eol are the line’s business; this is only the bytes after the colon.

pub fn component_count(&self) -> usize

The number of ;-separated components (at least one, since an empty value is one empty component).

pub fn decode_at(&self, i: usize) -> Vec<Cow<'_, str>>

Decode the ith component into a clean (unescaped) value list.

pub fn decode_bytes_at(&self, i: usize) -> Cow<'_, [u8]>

The ith component’s first value as raw unescaped bytes, not transcoded, for a value carrying a foreign charset.

pub fn decode_scalar_at(&self, i: usize) -> Cow<'_, str>

Decode the ith component’s first value (empty when there is none).

pub fn decode_joined_at(&self, i: usize) -> Cow<'_, str>

Decode the ith component as a single value, keeping its ,-separated pieces joined. For values like URIs whose comma is a literal part of the value, not a list separator (so they must not be truncated).

pub fn set_at<S: AsRef<str>>(&mut self, i: usize, values: &[S])

Set the ith component, escaping each value. Pads with empty components when needed; every other component is left untouched, so a parsed card keeps its bytes.

pub fn set_bytes_at<B: AsRef<[u8]>>(&mut self, i: usize, values: &[B])

Set the ith component from raw value bytes (the foreign-charset escape hatch), escaping structural separators but writing the bytes verbatim.

Trait Implementations

impl<'a> Clone for IcalValueNode<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for IcalValueNode<'a>

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

Formats the value using the given formatter.

impl<'a> Default for IcalValueNode<'a>

fn default() -> IcalValueNode<'a>

Returns the “default value” for a type.

impl Display for IcalValueNode<'_>

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

Formats the value using the given formatter.