fast-str 1.0.0

A flexible, easy-to-use, immutable, efficient `String` replacement for Rust.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

use crate::normal::NormalString;

#[repr(transparent)]
#[derive(Clone)]
pub struct FastStr(NormalString);

#[allow(unused)]
impl FastStr {
    #[inline]
    pub(super) fn do_sub_with<
        'a,
        R: 'a,
        F: FnOnce(&'a str, Box<dyn Fn(&str) -> Self + 'a>) -> R,
    >(
        &'a self,
        f: F,
    ) -> R {
        f(self.0.str, Box::new(|str| Self(self.0.map_ref(str))))
    }

    #[inline]
    pub(super) fn do_sub_into<F: FnOnce(&str) -> &str>(self, f: F) -> Self {
        let str = f(self.0.str);
        Self(self.0.map_ref_into(str))
    }

    /// Create an empty FastStr.
    #[inline]
    pub const fn new() -> Self {
        Self::from_static("")
    }

    /// Create a FastStr based on a `'static` data reference .
    #[inline]
    pub const fn from_static(str: &'static str) -> Self {
        Self(NormalString::from_static(str))
    }

    /// Create a FastStr based on String storage.
    #[inline]
    pub fn from_string(str: String) -> Self {
        Self(NormalString::from_string(str))
    }

    /// Create an FastStr and automatically use the best storage method.
    #[inline]
    pub fn from_ref(str: &str) -> Self {
        Self(NormalString::from_string(str.into()))
    }

    /// Converted to a string of standard [`String`] type.
    #[inline]
    pub fn into_string(self) -> String {
        self.0.into_string()
    }

    /// Extracts a string slice containing the entire [FastStr].
    #[inline]
    pub fn as_str(&self) -> &str {
        self.0.as_str()
    }

    /// Judge whether [FastStr] uses static storage.
    #[inline]
    pub fn is_static(&self) -> bool {
        self.0.is_static()
    }

    #[inline]
    pub fn static_str(&self) -> Option<&'static str> {
        self.0.static_str()
    }
}