cl-aux 5.1.0

Provides elements that describe collections
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

use crate::{Capacity, Clear, Push, Truncate, WithCapacity};
use core::ops::{Deref, DerefMut};

/// Dynamic Contiguous Collection
///
/// A growable vector-like abstraction for generic elements.
///
#[cfg_attr(feature = "alloc", doc = "```rust")]
#[cfg_attr(not(feature = "alloc"), doc = "```ignore")]
/// fn stuff<T>(dcc: &mut T)
/// where
///     T: cl_aux::DynContigColl<cl_aux::Error, u8>
/// {
///     dcc.clear();
///     dcc.extend([4, 5, 6]).unwrap();
///     dcc.truncate(1);
/// }
///
/// let mut dcc = vec![0, 1, 2, 3];
/// stuff(&mut dcc);
/// assert_eq!(dcc, &[4]);
/// ```
pub trait DynContigColl<E, T>:
  AsRef<[T]>
  + Clear
  + Capacity
  + Default
  + Deref<Target = [T]>
  + DerefMut
  + crate::Extend<T, Error = E>
  + Push<T, Error = E>
  + Truncate<Input = usize>
  + WithCapacity<Error = E, Input = usize>
{
}

impl<E, T, U> DynContigColl<E, T> for U where
  U: AsRef<[T]>
    + Clear
    + Capacity
    + Default
    + Deref<Target = [T]>
    + DerefMut
    + crate::Extend<T, Error = E>
    + Push<T, Error = E>
    + Truncate<Input = usize>
    + WithCapacity<Error = E, Input = usize>
{
}