examples.md

Examples

Document

Simple

using namespace myxml;
// `std::string xml`
document doc = document::parse(xml);
// or
doc = document::load(path);
// get root elem
std::optional<element> elem = doc.root().first_elem();
// or directly query elem in root
elem = doc.first_elem();
// or query by name
elem = doc.first_elem("elem");

Element

Basic

using namespace myxml;
element elem("root");
fmt::println(root->name());
root->set_name("far");

Attributes

using namespace myxml;
// create an element with name 'root'
element elem("root");
// or get an element from parsing
element elem = element::parse(xml);
// or do it by custom string literal
element elem = "<root/>"_elem;
// query attributes, it returns an string reference
fmt::println(elem["hello"]);
// modify attribute, will create new attribute if not found one
elem["hello"] = "world!";
// if key not exist, query it will create an empty attribute
elem["hello"]; // == elem["hello"] = "";

Children

using namespace myxml;
// element root;
element child = root.first_elem();
// or first element with name "child"
element child = root.first_elem("child");
// elements == vector<element>
std::vector<element> children = root.elems();
// or elements with same name
std::vector<element> children = root.elems("child");

Insertion

using namespace myxml;
element root("root");
element child("child");
root.push_back(child);
REQUIRE(root.first_elem().name() == "child");
element next("next");
root.push_front(next);
REQUIRE(root.first_elem().name() == "next");
root.push_back(text("Hello"));
REQUIRE(root.first_text().str() == "Hello");

Text

using namespace myxml;
// create from string
text txt = "Hello";
// or from query
text txt = root.first_text();
// print raw
fmt::println(txt);
// print trimmed string, it returns std::string and will not modify it
fmt::println(txt.trim());
// return a new trimmed text
fmt::println(txt.trimmed()); 

CData

// similar to text
using namespace myxml;
// create from string
cdata txt = "Hello";
// or from query
cdata txt = root.first_cdata();
// print raw
fmt::println(txt);