cl-aux 1.0.2

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

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

/// 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::String
/// {
///     s.clear();
///     s.push("World").unwrap();
///     s.truncate(1);
/// }
///
/// let mut s = String::from("Hello");
/// stuff(&mut s);
/// assert_eq!(s, "W");
/// ```
pub trait String:
  AsRef<str>
  + Clear
  + Default
  + Deref<Target = str>
  + DerefMut
  + crate::Extend<char>
  + for<'str> Push<&'str str, Error = crate::Error, Output = ()>
  + Truncate<Input = usize, Output = ()>
  + WithCapacity<Input = usize>
  + Write
{
}

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