xmlparsing(3)

✨ xmlparsing ✨

okay bestie, buckle up — this is the xmlparsing page from the Library Functions Manual, aka XML Parsing with Coin 🎀 and it's lowkey iconic.

So for Coin 3.0, we added an XML parser to Coin, and this doc is literally here to tell you how to use it for generic purposes. 💅

---

💖 NAME 💖

xmlparsing — XML Parsing with Coin

okay so, for Coin 3.0, we added an XML parser to Coin. This document describes how it can be used for generic purposes. 🫶

Now, "why another XML parser" you might ask? bestie, valid question, and the tea is: first of all, the XML parser is actually a third-party parser, expat. Coin needed one, and so did a whole bunch of Coin-dependent projects, so we needed to expose an API for it. but — and this is the plot twist — integrating a 3rd-party parser into Coin means we can't expose its API directly, because otherwise other projects also using Expat would get conflicts 😭. So we needed to expose the XML API with a unique API, hence the API you see here. It's based on an XML DOM API we use(d) in a couple of other projects, but it's been tweaked to fit into Coin and to be wrapped over Expat (the original implementation just used flex). slay.

The XML parser is both a streaming parser and a DOM parser. ✨

• Being a streaming parser means that documents can be read in without having to be fully contained in memory. iconic.
• When used as a DOM parser, the whole document is fully parsed in first, and then inspected by client code by traversing the DOM.

And the two modes can actually be mixed arbitrarily if ending up with a partial DOM sounds useful. main character energy fr fr 💅

The XML parser has both a C API and a C++ API. The C++ API is just a wrapper around the C API, and only serves as convenience if you prefer to read/write C++ code (which is tighter) over more verbose C code. 🦋

The C API naming convention may look a bit strange, unless you've written libraries to be wrapped for scheme/lisp-like languages before. Then you might be familiar with the convention of suffixing your functions based on their behaviour/usage meaning. 🧚

• Mutating functions are suffixed with "!", or "_x" for (eXclamation point).
• Predicates are suffixed with "?", or "_p" in C.

ngl if that sounds weird at first, that's just the vibe check of wrapped-library naming. iykyk 💜

The simplest way to use the XML parser is to just call cc_xml_read_file(filename) and then traverse the DOM model through using cc_xml_doc_get_root(), cc_xml_elt_get_child(), and cc_xml_elt_get_attr(). no cap, that's it. 🌸

---

👀 SEE ALSO 👀

• XML related functions and objects
• cc_xml_doc
• cc_xml_elt
• cc_xml_attr

---

and that's a wrap, bestie 🎀 this whole page is Coin, Version 3.1.3, and it's filed under xmlparsing(3). go parse something pretty 💖✨🦋