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
50
51
52
53
54
55
56

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

/// Dynamic String
///
/// Any owned growing string-like structure that `cl-aux` knows should implement this trait.
///
#[cfg_attr(feature = "alloc", doc = "```rust")]
#[cfg_attr(not(feature = "alloc"), doc = "```ignore")]
/// fn stuff<S>(s: &mut S)
/// where
///     S: cl_aux::DynString
/// {
///     s.clear();
///     s.push("World").unwrap();
///     s.truncate(1);
/// }
///
/// let mut s = String::from("Hello");
/// stuff(&mut s);
/// assert_eq!(s, "W");
/// ```
pub trait DynString:
  AsRef<str>
  + Capacity
  + Clear
  + Default
  + Deref<Target = str>
  + DerefMut
  + crate::Extend<char, Error = crate::Error>
  + Push<char, Error = crate::Error>
  + for<'str> Push<&'str str, Error = crate::Error>
  + Truncate<Input = usize>
  + WithCapacity<Input = usize>
  + Write
{
}

impl<T> DynString for T where
  T: AsRef<str>
    + Capacity
    + Clear
    + Default
    + Deref<Target = str>
    + DerefMut
    + crate::Extend<char, Error = crate::Error>
    + Push<char, Error = crate::Error>
    + for<'str> Push<&'str str, Error = crate::Error>
    + Truncate<Input = usize>
    + WithCapacity<Input = usize>
    + Write
{
}