待办事项

• 由于命名空间规范对名称中使用":"施加了约束，因此提供了namespace-aware=false选项来解析其他有效的XML 1.0文档。
• 更多测试
• 解析每个实体（包括DTD），以便能够利用合规性测试套件。

示例用法

在此示例中，统计了StartElement和EndElement事件。注意，您可以在tests目录下找到更多示例。

• StartElement还包括空标签。通过is_empty进行检查。
• 像&或<这样的引用实体在自己的事件中出现（不在Characters中）。
• 解析字符/数值和预定义实体引用。自定义实体定义以原始形式传递。
• 查看sax::Event以了解所有可用事件类型

use std::fs::File;
use xml_oxide::{sax::parser::Parser, sax::Event};


fn main() {
    println!("Starting...");

    let mut counter: usize = 0;
    let mut end_counter: usize = 0;

    let now = std::time::Instant::now();

    let f = File::open("./tests/xml_files/books.xml").unwrap();

    let mut p = Parser::from_reader(f);

    loop {
        let res = p.read_event();

        match res {
            Ok(event) => match event {
                Event::StartDocument => {}
                Event::EndDocument => {
                    break;
                }
                Event::StartElement(el) => {
                    //You can differantiate between Starting Tag and Empty Element Tag
                    if !el.is_empty {
                        counter = counter + 1;
                        // print every 10000th element name
                        if counter % 10000 == 0 {
                            println!("%10000 start {}", el.name);
                        }
                    }
                }
                Event::EndElement(el) => {
                    end_counter += 1;
                    if el.name == "feed" {
                        break;
                    }
                }
                Event::Characters(_) => {}
                Event::Reference(_) => {}
                _ => {}
            },
            Err(err) => {
                println!("{}", err);
                break;
            }
        }
    }

    println!("Start event count:{}", counter);
    println!("End event count:{}", end_counter);

    let elapsed = now.elapsed();
    println!("Time elapsed: {:.2?}", elapsed);
}

历史 & 信用

我试图在2017年指定一个类似于Java SAX库的推送解析器接口并实现它。这个想法是提供一个可以由社区中的多个实现使用的接口。它工作着（尽管速度较慢），但主要问题是推送解析器在Rust中不便于使用。经过长时间的思考和对Rust的进一步了解，我决定实现一个拉取解析器。目前，SAX（拉取）接口只是一个enum及其行为（如每个调用分割字符的可能性）。

如果您想使用xml_sax接口实现另一个解析器，我们可以讨论改进接口。目前，它已集成到这个crate中。

pulldown-cmark中的Why a pull parser?部分是一个很好的解释。

当前接口受到了quick-xml、xml-rs和Java库的启发。

nom是一个很棒的库。它只是你最初尝试时可能会做的事情的结晶和更好的版本（我知道）。它还展示了Rust中组合性的力量。