pub struct Vector<'scope, A: Allocator> { /* private fields */ }Expand description
An exclusive scalar view, with no Deref, Clone or owning iterator.
Scalar slices cannot expose the Vec carrier to mem::take or mem::replace:
ⓘ
use ic_storage::with_vector;
let mut values = vec![17];
with_vector(&mut values, 512, |mut view| {
let _: Vec<u64> = core::mem::take(view.values_mut());
});ⓘ
use ic_storage::with_vector;
let mut values = vec![17];
with_vector(&mut values, 512, |mut view| {
let _ = core::mem::replace(view.values_mut(), Vec::<u64>::new());
});Borrowed elements cannot escape:
ⓘ
use ic_storage::with_vector;
let mut values = vec![17];
let escaped = with_vector(&mut values, 512, |view| view.values());Consuming iteration cannot extract the carrier:
ⓘ
use ic_storage::with_vector;
let mut values = vec![17];
with_vector(&mut values, 512, |view| view.into_iter());The view cannot clone an owning carrier:
ⓘ
use ic_storage::with_vector;
let mut values = vec![17];
with_vector(&mut values, 512, |view| view.clone());Implementations§
Source§impl<A: Allocator> Vector<'_, A>
impl<A: Allocator> Vector<'_, A>
Sourcepub fn values(&self) -> &[u64]
pub fn values(&self) -> &[u64]
Borrow only initialized scalar values, never spare capacity or the owner.
Sourcepub fn values_mut(&mut self) -> &mut [u64]
pub fn values_mut(&mut self) -> &mut [u64]
Mutate non-owning scalar elements without changing vector ownership.
Sourcepub fn push(&mut self, value: u64) -> Result<(), Refusal>
pub fn push(&mut self, value: u64) -> Result<(), Refusal>
Append one scalar after checking the logical limit and reserving space.
Sourcepub fn remove_first(&mut self) -> Option<u64>
pub fn remove_first(&mut self) -> Option<u64>
Remove the first scalar, preserving the order of remaining values.
Sourcepub fn shrink_to_fit(&mut self)
pub fn shrink_to_fit(&mut self)
Ask the existing allocator to reduce spare capacity; no platform-page claim.
Auto Trait Implementations§
impl<'scope, A> !UnwindSafe for Vector<'scope, A>
impl<'scope, A> Forget for Vector<'scope, A>
impl<'scope, A> Freeze for Vector<'scope, A>
impl<'scope, A> Move for Vector<'scope, A>
impl<'scope, A> RefUnwindSafe for Vector<'scope, A>
impl<'scope, A> Send for Vector<'scope, A>
impl<'scope, A> Sync for Vector<'scope, A>
impl<'scope, A> Unpin for Vector<'scope, A>
impl<'scope, A> UnsafeUnpin for Vector<'scope, A>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more