Struct git_config::file::MutableMultiValue

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

An intermediate representation of a mutable multivar obtained from GitConfig.

This holds a mutable reference to the underlying data structure of GitConfig, and thus guarantees through Rust’s borrower checker that multiple mutable references to GitConfig cannot be owned at the same time.

Implementations

impl<'borrow, 'lookup, 'event> MutableMultiValue<'borrow, 'lookup, 'event>

pub fn get(&self) -> Result<Vec<Cow<'_, [u8]>>, GitConfigError<'_>>

Returns the actual values. This is computed each time this is called.

Errors

Returns an error if the lookup failed.

pub fn len(&self) -> usize

Returns the size of values the multivar has.

pub fn is_empty(&self) -> bool

Returns if the multivar has any values. This might occur if the value was deleted but not set with a new value.

pub fn set_string(&mut self, index: usize, input: String)

Sets the value at the given index.

Safety

This will panic if the index is out of range.

pub fn set_bytes(&mut self, index: usize, input: Vec<u8>)

Sets the value at the given index.

Safety

This will panic if the index is out of range.

pub fn set_value<'a: 'event>(&mut self, index: usize, input: Cow<'a, [u8]>)

Sets the value at the given index.

Safety

This will panic if the index is out of range.

pub fn set_values<'a: 'event>(
    &mut self,
    input: impl Iterator<Item = Cow<'a, [u8]>>
)

Sets all values to the provided values. 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_str_all(&mut self, input: &str)

Sets all values in this multivar to the provided one by copying the input for all values.

pub fn set_owned_values_all(&mut self, input: &[u8])

Sets all values in this multivar to the provided one by copying the input bytes for all values.

pub fn set_values_all<'a: 'event>(&mut self, input: &'a [u8])

Sets all values in this multivar to the provided one without owning the provided input. Note that this requires input to last longer than GitConfig. Consider using Self::set_owned_values_all or Self::set_str_all unless you have a strict performance or memory need for a more ergonomic interface.

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

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

Formats the value using the given formatter.

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

fn eq(&self, other: &MutableMultiValue<'borrow, 'lookup, 'event>) -> bool

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

fn ne(&self, other: &MutableMultiValue<'borrow, 'lookup, 'event>) -> bool

This method tests for !=.

impl<'borrow, 'lookup, 'event> Eq for MutableMultiValue<'borrow, 'lookup, 'event>

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

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