hexml-0.1: cbits/hexml.h

#include <stdint.h>

typedef struct document document;

// Pair of indexes into the input string
typedef struct
{
    int32_t start;
    int32_t length;
} str;

typedef struct
{
    str name;
    str value;
} attr;

typedef struct
{
    str name; // tag name, e.g. <[foo]>
    str inner; // inner text, <foo>[bar]</foo>
    str outer; // outer text, [<foo>bar</foo>]
    str attrs; // all the attributes, in the attribute buffer (not usable)
    str nodes; // all the nodes, in the node buffer (not usable)
} node;

// Convention: if slen can be -1 for nul-terminated, or given explicitly

// Parse a document, returns a potentially invalid document - use document_error to check
// Must use document_free to release the memory (even if invalid).
// The string must be nul terminated, e.g. slen != -1 ==> slen[0]
document* document_parse(char* s, int slen);

// Free the memory returned from document_parse.
void document_free(document* d);

// Generate a fresh string with the same semantics as the node.
// Requires an input buffer, returns the size of the rendered document.
// Requires the string passed to document_parse to be valid.
int node_render(document* d, node* n, char* buffer, int length);

// Return either NULL (successful parse) or the error message.
char* document_error(document* d);

// Return the root node of the document - imagine the document is wrapped in <>$DOC</> tags.
node* document_node(document* d);

// List all items within a node
node* node_children(document* d, node* n, int* res);
attr* node_attributes(document* d, node* n, int* res);

// Search for given strings within a node, note that prev may be NULL
// Requires the string passed to document_parse to be valid.
node* node_childBy(document* d, node* parent, node* prev, char* s, int slen);
attr* node_attributeBy(document* d, node* n, char* s, int slen);