Struct MultiValueMut

pub struct MultiValueMut<'borrow, 'lookup, 'event> { /* private fields */ }

An intermediate representation of a mutable multivar obtained from a File.

Implementations

impl<'lookup, 'event> MultiValueMut<'_, 'lookup, 'event>

pub fn get(&self) -> Result<Vec<Cow<'_, BStr>>, Error>

Returns the actual values.

pub fn len(&self) -> usize

Returns the amount of values within this multivar.

pub fn is_empty(&self) -> bool

Returns true if the multivar does not have any values. This might occur if the value was deleted but wasn’t yet set with a new value.

pub fn set_string_at(&mut self, index: usize, value: impl AsRef<str>)

Sets the value at the given index.

Safety

This will panic if the index is out of range.

pub fn set_at<'a>(&mut self, index: usize, value: impl Into<&'a BStr>)

Sets the value at the given index.

Safety

This will panic if the index is out of range.

pub fn set_values<'a, Iter, Item>(&mut self, values: Iter)

where Iter: IntoIterator<Item = Item>, Item: Into<&'a BStr>,

Sets all values to the provided ones. Note that this follows zip logic: if the number of values in the input is less than the number of values currently existing, then only the first n values are modified. If more values are provided than there currently are, then the remaining values are ignored.

pub fn set_all<'a>(&mut self, input: impl Into<&'a BStr>)

Sets all values in this multivar to the provided one without owning the provided input.

pub fn delete(&mut self, index: usize)

Removes the value at the given index. Does nothing when called multiple times in succession.

Safety

This will panic if the index is out of range.

pub fn delete_all(&mut self)

Removes all values. Does nothing when called multiple times in succession.

Trait Implementations

impl<'borrow, 'lookup, 'event> Debug for MultiValueMut<'borrow, 'lookup, 'event>

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

Formats the value using the given formatter.

impl<'borrow, 'lookup, 'event> PartialEq for MultiValueMut<'borrow, 'lookup, 'event>

fn eq(&self, other: &MultiValueMut<'borrow, 'lookup, 'event>) -> 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<'borrow, 'lookup, 'event> Eq for MultiValueMut<'borrow, 'lookup, 'event>

impl<'borrow, 'lookup, 'event> StructuralPartialEq for MultiValueMut<'borrow, 'lookup, 'event>