document.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
 
#ifndef MODDEF_DOCUMENT_HPP
#define MODDEF_DOCUMENT_HPP
 
#include <cstddef>
#include <cstdint>
#include <span>
#include <string_view>
#include <utility>
#include <vector>
 
#include "moddef/error.hpp"
#include "moddef/str.hpp"
 
extern "C" {
#include "moddef/doc.h"
}
 
namespace moddef {
 
class Document {
   public:
    static Result<Document> view(std::span<const std::uint8_t> bytes) {
        Document d;
        if (auto e = md_doc_init(&d.doc_, bytes.data(), bytes.size()); e != MD_OK)
            return std::unexpected(from_c(e));
        return d;
    }
 
    static Result<Document> own(std::vector<std::uint8_t> bytes) {
        Document d;
        d.storage_ = std::move(bytes);
        if (auto e = md_doc_init(&d.doc_, d.storage_.data(), d.storage_.size()); e != MD_OK)
            return std::unexpected(from_c(e));
        return d;
    }
 
    std::string_view doc_id() const noexcept { return from_c(md_doc_id(&doc_)); }
 
    const md_doc_t* c_doc() const noexcept { return &doc_; }
 
    // Movable: the owned buffer (if any) keeps its heap address across a move,
    // so the C view stays valid; the view is repointed for clarity.
    Document(Document&& o) noexcept : storage_(std::move(o.storage_)), doc_(o.doc_) {
        if (!storage_.empty()) {
            doc_.raw.p = storage_.data();
            doc_.raw.len = static_cast<std::uint32_t>(storage_.size());
        }
    }
    Document& operator=(Document&& o) noexcept {
        storage_ = std::move(o.storage_);
        doc_ = o.doc_;
        if (!storage_.empty()) {
            doc_.raw.p = storage_.data();
            doc_.raw.len = static_cast<std::uint32_t>(storage_.size());
        }
        return *this;
    }
    Document(const Document&) = delete;
    Document& operator=(const Document&) = delete;
 
   private:
    Document() = default;
 
    std::vector<std::uint8_t> storage_;  // empty in view mode
    md_doc_t doc_{};
};
 
}  // namespace moddef
 
#endif  // MODDEF_DOCUMENT_HPP