exml 0.7.2

Pure Rust XML library based on libxml2
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

// Copyright of the original code is the following.
// --------
// Summary: interfaces for tree manipulation
// Description: this module describes the structures found in an tree resulting
//              from an XML or HTML parsing, as well as the API provided for
//              various processing on that tree
//
// Copy: See Copyright for the status of this software.
//
// Author: Daniel Veillard
// --------
// tree.c : implementation of access function for an XML tree.
//
// References:
//   XHTML 1.0 W3C REC: http://www.w3.org/TR/2002/REC-xhtml1-20020801/
//
// See Copyright for the status of this software.
//
// daniel@veillard.com

#[cfg(feature = "libxml_output")]
use std::io::Write;

/// List structure used when there is an enumeration in DTDs.
// pub type XmlEnumerationPtr = *mut XmlEnumeration;
#[repr(C)]
#[derive(Debug, Default)]
pub struct XmlEnumeration {
    // next one
    pub next: Option<Box<XmlEnumeration>>,
    // Enumeration name
    pub name: String,
}

impl Clone for XmlEnumeration {
    #[doc(alias = "xmlCopyEnumeration")]
    fn clone(&self) -> Self {
        Self {
            next: self.next.as_deref().map(|next| Box::new(next.clone())),
            name: self.name.clone(),
        }
    }
}

/// create and initialize an enumeration attribute node.
///
/// Return a boxed `XmlEnumeration` whose name is `name`.
#[doc(alias = "xmlCreateEnumeration")]
pub fn xml_create_enumeration(name: &str) -> Box<XmlEnumeration> {
    Box::new(XmlEnumeration {
        name: name.to_owned(),
        next: None,
    })
}

/// This will dump the content of the enumeration
///
/// # Note
/// '(' is not printed.
#[doc(alias = "xmlDumpEnumeration")]
#[cfg(feature = "libxml_output")]
pub(crate) fn xml_dump_enumeration<'a>(out: &mut (impl Write + 'a), cur: &XmlEnumeration) {
    write!(out, "{}", cur.name).ok();
    if let Some(next) = cur.next.as_deref() {
        write!(out, " | ").ok();
        xml_dump_enumeration(out, next);
    } else {
        write!(out, ")").ok();
    }
}