pstd 1.0.87

Crate with parts of Rust std library ( different implementations, features not yet stabilised etc ).
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use crate::Vec;
use crate::alloc::{Allocator, Global};
use std::ops;

/// A UTF-8–encoded, growable string.
#[derive(Clone, Debug)]
pub struct String<A: Allocator = Global>(Vec<u8, A>);

impl<A: Allocator> String<A> {

    /// Create an empty string.
    pub fn new() -> Self where A:Default
    {
        Self( Vec::new_in( A::default() ) )
    }

    /// Creates a String from a str.
    pub fn from_str(s: &str) -> Self where A:Default {
        let mut v = Vec::with_capacity_in(s.len(), A::default() );
        v.extend_from_slice(s.as_bytes());
        Self(v)
    }
    
    /// Creates a String from a str in the specified allocator.
    pub fn from_str_in(s: &str, alloc: A) -> Self {
        let mut v = Vec::with_capacity_in(s.len(), alloc);
        v.extend_from_slice(s.as_bytes());
        Self(v)
    }

    /// Appends a given string slice onto the end of this `String`.
    /// # Example
    ///
    /// ```
    /// use pstd::{String,alloc::Global};
    /// let mut s = String::from_str_in("foo",Global);
    ///
    /// s.push_str("bar");
    ///
    /// assert_eq!("foobar", &*s);
    /// ```
    pub fn push_str(&mut self, string: &str) {
        self.0.extend_from_slice(string.as_bytes())
    }

    /// Extracts a string slice containing the entire String.
    pub fn as_str(&self) -> &str {
        unsafe { str::from_utf8_unchecked(self.0.as_slice()) }
    }

    /// Converts a String into a mutable string slice.
    pub fn as_mut_str(&mut self) -> &mut str {
        unsafe { str::from_utf8_unchecked_mut(self.0.as_mut_slice()) }
    }
}

impl<A: Allocator> ops::Deref for String<A> {
    type Target = str;

    fn deref(&self) -> &str {
        self.as_str()
    }
}

impl<A: Allocator> ops::DerefMut for String<A> {
    fn deref_mut(&mut self) -> &mut str {
        self.as_mut_str()
    }
}

impl<A: Allocator> std::fmt::Display for String<A> {
    #[inline]
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        std::fmt::Display::fmt(&**self, f)
    }
}

impl<A: Allocator> std::hash::Hash for String<A> {
    fn hash<H: std::hash::Hasher>(&self, hasher: &mut H) {
        (**self).hash(hasher)
    }
}

impl<A: Allocator> Eq for String<A> {}

impl<A1: Allocator, A2: Allocator> PartialEq<String<A2>> for String<A1> {
    fn eq(&self, other: &String<A2>) -> bool {
        self[..] == other[..]
    }
}

impl<A1, A2> PartialOrd<String<A2>> for String<A1>
where
    A1: Allocator,
    A2: Allocator,
{
    fn partial_cmp(&self, other: &String<A2>) -> Option<std::cmp::Ordering> {
        PartialOrd::partial_cmp(&**self, &**other)
    }
}

impl<A: Allocator> Ord for String<A> {
    fn cmp(&self, other: &Self) -> std::cmp::Ordering {
        std::cmp::Ord::cmp(&**self, &**other)
    }
}

#[test]
fn test_string()
{
    use crate::localalloc::Local;
    use std::ops::Deref;
    
    let mut s : String::<Local> = String::new();
    s.push_str("George");
    assert!( s.deref() == "George" );
}