parse.h

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright 2016, Olivier MATZ <zer0@droids-corp.org>
 */
 
#pragma once
 
#include <limits.h>
#include <stdbool.h>
#include <stdio.h>
#include <sys/queue.h>
#include <sys/types.h>
 
struct ec_node;
 
struct ec_pnode;
 
struct ec_pnode *ec_pnode(const struct ec_node *node);
 
void ec_pnode_free(struct ec_pnode *pnode);
 
void ec_pnode_free_children(struct ec_pnode *pnode);
 
struct ec_pnode *ec_pnode_dup(const struct ec_pnode *pnode);
 
const struct ec_strvec *ec_pnode_get_strvec(const struct ec_pnode *pnode);
 
struct ec_pnode *ec_parse(const struct ec_node *node, const char *str);
 
struct ec_pnode *ec_parse_strvec(const struct ec_node *node, const struct ec_strvec *strvec);
 
#define EC_PARSE_NOMATCH INT_MAX
 
int ec_parse_child(
    const struct ec_node *node,
    struct ec_pnode *pstate,
    const struct ec_strvec *strvec
);
 
void ec_pnode_link_child(struct ec_pnode *pnode, struct ec_pnode *child);
 
void ec_pnode_unlink_child(struct ec_pnode *child);
 
#define EC_PNODE_GET_ROOT(parse)                                                                   \
    ({                                                                                         \
        const struct ec_pnode *p_ = parse; /* check type */                                \
        struct ec_pnode *pnode_ = (struct ec_pnode *)parse;                                \
        __typeof__(parse) res_;                                                            \
        (void)p_;                                                                          \
        res_ = ec_pnode_get_root(pnode_);                                                  \
        res_;                                                                              \
    })
 
struct ec_pnode *ec_pnode_get_root(struct ec_pnode *pnode);
 
struct ec_pnode *ec_pnode_get_parent(const struct ec_pnode *pnode);
 
struct ec_pnode *ec_pnode_get_first_child(const struct ec_pnode *pnode);
 
struct ec_pnode *ec_pnode_get_last_child(const struct ec_pnode *pnode);
 
struct ec_pnode *ec_pnode_next(const struct ec_pnode *pnode);
 
#define EC_PNODE_FOREACH_CHILD(child, pnode)                                                       \
    for (child = ec_pnode_get_first_child(pnode); child != NULL; child = ec_pnode_next(child))
 
const struct ec_node *ec_pnode_get_node(const struct ec_pnode *pnode);
 
void ec_pnode_del_last_child(struct ec_pnode *pnode);
 
struct ec_dict *ec_pnode_get_attrs(const struct ec_pnode *pnode);
 
void ec_pnode_dump(FILE *out, const struct ec_pnode *pnode);
 
const struct ec_pnode *ec_pnode_find(const struct ec_pnode *root, const char *id);
 
const struct ec_pnode *ec_pnode_find_next(
    const struct ec_pnode *root,
    const struct ec_pnode *prev,
    const char *id,
    bool iter_children
);
 
unsigned int ec_pnode_count(const struct ec_pnode *root, const char *id);
 
struct ec_pnode *
__ec_pnode_iter_next(const struct ec_pnode *root, struct ec_pnode *pnode, bool iter_children);
 
#define EC_PNODE_ITER_NEXT(root, parse, iter_children)                                             \
    ({                                                                                         \
        const struct ec_pnode *p_ = parse; /* check type */                                \
        struct ec_pnode *pnode_ = (struct ec_pnode *)parse;                                \
        __typeof__(parse) res_;                                                            \
        (void)p_;                                                                          \
        res_ = __ec_pnode_iter_next(root, pnode_, iter_children);                          \
        res_;                                                                              \
    })
 
#define EC_PNODE_FOREACH(iter, root)                                                               \
    for ((iter) = (root); (iter) != NULL; (iter) = EC_PNODE_ITER_NEXT((root), (iter), true))
 
size_t ec_pnode_len(const struct ec_pnode *pnode);
 
bool ec_pnode_matches(const struct ec_pnode *pnode);