microstr 0.4.0

Stack-allocated string with fixed capacity
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

#[macro_export]
/// Creates a `MicroStr` containing the string slice.
/// 
/// `microstr!` allows optional argument `cap`
/// 
/// # Example
/// 
/// ```rust
/// use microstr::microstr;
/// let s_without_cap = microstr!("Hello, world");
/// let s_with_cap = microstr!("Hello, world", 20);
/// let s_with_less_cap = microstr!("Hello, world", 5);
/// 
/// assert_eq!(s_without_cap.capacity(), 12); // Minimal capacity to containing this string
/// assert_eq!(s_with_cap.capacity(), 20); // Capacity is set by user
/// assert_eq!(s_with_less_cap.capacity(), 5); // Capacity is set by user
/// assert_eq!(s_with_less_cap.as_str(), "Hello"); // Truncated
/// ```
macro_rules! microstr {
    ($s:expr) => {
        {
            const STR : &str = $s;
            const LEN : usize = STR.len();
            unsafe { $crate::MicroStr::<{LEN}>::from_str_unchecked(STR) }
        }
    };
    ($s:expr, $cap:expr) => {
        {
            $crate::MicroStr::<{$cap}>::from_const($s)
        }
    };
}