xml_dom 0.2.3

A Rust crate providing a reasonably faithful implementation of the W3C DOM Core
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

#[doc(hidden)]
#[macro_export]
macro_rules! make_ref_type {
    ($ref_t:ident, $trait_t:ident) => {
        /// **Ref** type for dynamic trait cast
        pub type $ref_t<'a> = &'a dyn $trait_t<NodeRef = RefNode>;
    };
    ($ref_t:ident, $mut_t:ident, $trait_t:ident) => {
        /// **Ref** type for dynamic trait cast
        pub type $ref_t<'a> = &'a dyn $trait_t<NodeRef = RefNode>;
        /// Mutable **Ref** type for mutable dynamic trait cast
        pub type $mut_t<'a> = &'a mut dyn $trait_t<NodeRef = RefNode>;
    };
}

#[doc(hidden)]
#[macro_export]
macro_rules! make_is_as_functions {
    ($is_f:ident, $is_t:expr, $as_f:ident, $as_t:ident) => {
        ///
        /// Determines if the specified node is of the correct node type.
        ///
        #[inline]
        pub fn $is_f(ref_node: &RefNode) -> bool {
            ref_node.borrow().i_node_type == $is_t
        }

        ///
        /// Safely _cast_ the specified `RefNode` into a **Ref** type.
        ///
        #[inline]
        pub fn $as_f(ref_node: &RefNode) -> Result<$as_t<'_>> {
            if ref_node.borrow().i_node_type == $is_t {
                Ok(ref_node as $as_t<'_>)
            } else {
                warn!("{}", MSG_INVALID_NODE_TYPE);
                Err(Error::InvalidState)
            }
        }
    };
    ($is_f:ident, $is_t:expr, $as_f:ident, $as_t:ident, $as_mut_f:ident, $as_mut_t:ident) => {
        ///
        /// Determines if the specified node is of the correct node type.
        ///
        #[inline]
        pub fn $is_f(ref_node: &RefNode) -> bool {
            ref_node.borrow().i_node_type == $is_t
        }

        ///
        /// Safely _cast_ the specified `RefNode` into a **Ref** type.
        ///
        #[inline]
        pub fn $as_f(ref_node: &RefNode) -> Result<$as_t<'_>> {
            if ref_node.borrow().i_node_type == $is_t {
                Ok(ref_node as $as_t<'_>)
            } else {
                warn!("{}", MSG_INVALID_NODE_TYPE);
                Err(Error::InvalidState)
            }
        }

        ///
        /// Safely _cast_ the specified `RefNode` into a mutable **Ref** type.
        ///
        #[inline]
        pub fn $as_mut_f(ref_node: &mut RefNode) -> Result<$as_mut_t<'_>> {
            if ref_node.borrow().i_node_type == $is_t {
                Ok(ref_node as $as_mut_t<'_>)
            } else {
                warn!("{}", MSG_INVALID_NODE_TYPE);
                Err(Error::InvalidState)
            }
        }
    };
}