Struct git_config::file::MultiValueMut

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

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

Implementations

impl<'borrow, 'lookup, 'event> MultiValueMut<'borrow, '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.

Examples found in repository

src/file/mutable/multi_value.rs (line 95)

    pub fn set_string_at(&mut self, index: usize, value: impl AsRef<str>) {
        self.set_at(index, value.as_ref());
    }

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.

Examples found in repository

src/file/access/raw.rs (line 534)

    pub fn set_existing_raw_multi_value<'a, Iter, Item>(
        &mut self,
        section_name: impl AsRef<str>,
        subsection_name: Option<&BStr>,
        key: impl AsRef<str>,
        new_values: Iter,
    ) -> Result<(), lookup::existing::Error>
    where
        Iter: IntoIterator<Item = Item>,
        Item: Into<&'a BStr>,
    {
        self.raw_values_mut(section_name, subsection_name, key.as_ref())
            .map(|mut v| v.set_values(new_values))
    }

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<MultiValueMut<'borrow, 'lookup, 'event>> for MultiValueMut<'borrow, 'lookup, 'event>

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

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

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