soft-ascii-string 1.1.0

char/str/string wrappers which add a "is-ascii" soft constraint
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

use std::fmt::{self, Debug};
use std::error::Error;

/// Error returned if FromStr failed
#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]
pub struct StringFromStrError;
impl Error for StringFromStrError {
    fn description(&self) -> &str {
        "&str does contain non us-ascii chars and can not be converted to a SoftAsciiString"
    }
}

impl fmt::Display for StringFromStrError {
    fn fmt(&self, fter: &mut fmt::Formatter) -> fmt::Result {
        write!(fter, "{}", self.description())
    }
}

/// Error returned if creating a SoftAsciiStr/SoftAsciiString failed
#[derive(Debug, PartialEq, Eq, Clone, Hash)]
pub struct FromSourceError<S: Debug> {
    source: S
}

impl<S> FromSourceError<S>
    where S: Debug
{

    /// creates a new FromSourceError
    pub fn new(source: S) -> Self {
        FromSourceError { source }
    }

    /// returns a reference to the source
    ///
    /// the source is the input which was meant to be converted into a
    /// SoftAsciiStr/String
    pub fn source(&self) -> &S {
        &self.source
    }


    // Note that Into, can not be implemented due to possible conflicting
    // implementations
    /// returns the source
    ///
    /// the source is the input which was meant to be converted into a
    /// SoftAsciiStr/String
    pub fn into_source(self) -> S {
        self.source
    }
}



impl<S> Error for FromSourceError<S>
    where S: Debug
{
    fn description(&self) -> &str {
        concat!("could not create a SoftAscii representation of the source",
                "as the source contained non us-ascii chars")
    }
}

impl<S> fmt::Display for FromSourceError<S>
    where S: Debug
{
    fn fmt(&self, fter: &mut fmt::Formatter) -> fmt::Result {
        write!(fter, "source contains non us-ascii chars: {:?}", self.source)
    }
}