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

//! Error management module

use std::fmt;
use std::io;
use std::str::Utf8Error;

/// An error produced by an operation on Xml data.
#[derive(Debug)]
pub enum Error {
    /// An error originating from reading or writing to the underlying buffer.
    Io(io::Error),
    /// An error originating from finding end of line instead of a column.
    EOL,
    /// An error while converting to utf8
    Utf8(Utf8Error),
    /// Xml is malformed
    Malformed(String),
    /// Unexpected
    Unexpected(String),
}

/// Result type
pub type Result<T> = ::std::result::Result<T, Error>;
/// Result type with position
///
/// Position represents byte index relative to
///
/// - xml file when iterating xml `Event`s
/// - element node when iterating on `Attribute`s. You can find xml
/// relative position using `XmlReader::buffer_position`
pub type ResultPos<T> = ::std::result::Result<T, (Error, usize)>;

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            Error::Io(ref err) => write!(f, "{}", err),
            Error::Utf8(ref err) => write!(f, "{}", err),
            Error::EOL => write!(f, "Trying to access column but found End Of Line"),
            Error::Malformed(ref err) => write!(f, "Malformed xml: {}", err),
            Error::Unexpected(ref err) => write!(f, "Unexpected error: {}", err),
        }
    }
}

impl ::std::error::Error for Error {
    fn description(&self) -> &str {
        match *self {
            Error::Io(..) => "IO error",
            Error::Utf8(..) => "Error while converting to utf8",
            Error::EOL => "Trying to access column but found End Of Line",
            Error::Malformed(..) => "Xml is malformed",
            Error::Unexpected(..) => "An unexpected error has occured",
        }
    }

    fn cause(&self) -> Option<&::std::error::Error> {
        match *self {
            Error::Io(ref err) => Some(err),
            Error::Utf8(ref err) => Some(err),
            _ => None,
        }
    }
}

impl From<io::Error> for Error {
    fn from(err: io::Error) -> Error {
        Error::Io(err)
    }
}

impl From<Utf8Error> for Error {
    fn from(err: Utf8Error) -> Error {
        Error::Utf8(err)
    }
}