Xml.h

浏览该文件的文档.

#pragma once
 
// Lightweight read-only XML facade for config / tileset documents (e.g. Tiled
// TSX). Self-contained recursive-descent parser — no Poco — so EVCommon stays
// dependency-free and modules that only need attribute-oriented XML do not pull
// the full Poco DOM stack. Writing XML is out of scope; use data::XmlDocument
// (Poco) only for legacy mutable encode/decode round-trips.
//
// Accessors never throw: a missing attribute or tag yields the supplied
// default (or an empty Element).
 
#include "common/Export.h"
 
#include <cstddef>
#include <memory>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::xml {
 
struct Node;
class Document;
 
class EVENGINE_API_FOUNDATION Element {
public:
    Element() = default;
 
    explicit operator bool() const { return node_ != nullptr; }
 
    bool operator==(const Element& other) const { return node_ == other.node_; }
    bool operator!=(const Element& other) const { return node_ != other.node_; }
 
    std::string tagName() const;
 
    Element parent() const;
 
    bool        hasAttribute(const char* name) const;
    std::string getAttribute(const char* name, const std::string& fallback = {}) const;
    int         getIntAttribute(const char* name, int fallback = 0) const;
 
    std::vector<Element> children(const char* tag = nullptr) const;
 
    std::vector<Element> elementsByTag(const char* tag) const;
 
private:
    friend class Document;
    explicit Element(const Node* node) : node_(node) {}
    const Node* node_ = nullptr;
};
 
class EVENGINE_API_FOUNDATION Document {
public:
    Document();
    ~Document();
    Document(Document&&) noexcept;
    Document& operator=(Document&&) noexcept;
    Document(const Document&)            = delete;
    Document& operator=(const Document&) = delete;
 
    static Document parse(const std::string& text, std::string* error = nullptr);
 
    bool    valid() const { return root_ != nullptr; }
    Element root() const { return Element(root_.get()); }
 
private:
    std::unique_ptr<Node> root_;
};
 
}  // namespace eve::xml