Struct vecrem::Entry

pub struct Entry<'a, 'rem, T> { /* fields omitted */ }

Vec entry.

Entry allows you to remove, read or mutate the element behind it.

The only way to get this struct is to call Removing::next method.

forget behavior

When Entry destructor (drop) is not runned (this can be achieved via mem::forget, ManuallyDrop, etc) the entry is not skiped and the next call to Removing::next returns the same entry.

use core::mem;
use vecrem::VecExt;

let mut vec = vec![1, 2, 3];
{
    let mut rem = vec.removing();

    let a = rem.next().unwrap();
    assert_eq!(a.value(), &1);
    mem::forget(a);

    let b = rem.next().unwrap();
    assert_eq!(b.value(), &1);
    mem::forget(b);
}
assert_eq!(vec, [1, 2, 3]);

Implementations

impl<T> Entry<'_, '_, T>

pub fn remove(self) -> T

Remove element behind this entry.

pub fn value(&self) -> &T

Get access to the element behind this entry.

pub fn value_mut(&mut self) -> &mut T

Get unique access to the element behind this entry.

pub fn peek_next(&mut self) -> Option<&mut T>

Get unique access to the element after the element behind this entry.

Returns None if this entry corresponds to the last item in the vec.

Trait Implementations

impl<T> Drop for Entry<'_, '_, T>

pub fn drop(&mut self)

Executes the destructor for this type.