grammar.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2025-2026 Metehan Selvi <me@metehanselvi.com>
//
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#ifndef RDESC_GRAMMAR_H
#define RDESC_GRAMMAR_H
 
#include "detail.h"
 
#include <stdint.h>
 
 
#define rdesc_grammar_init_checked(grammar, \
                                   production_count, \
                                   max_alternative_count, \
                                   max_alternative_size, \
                                   production_rules) \
        _rdesc_priv_grammar_init_checked( \
                grammar, \
                production_count, max_alternative_count, max_alternative_size, \
                (struct rdesc_grammar_symbol *) production_rules, \
                sizeof(production_rules) / sizeof(struct rdesc_grammar_symbol) == \
                        production_count * \
                        (max_alternative_count + 1) * \
                        (max_alternative_size + 1)\
        )
 
 
struct rdesc_grammar {
        const struct rdesc_grammar_symbol *rules;
 
        uint16_t production_count;
 
        uint16_t max_alternative_count;
 
        uint16_t max_alternative_size;
 
        uint16_t *child_caps;
};
 
enum rdesc_grammar_symbol_type {
        RDESC_TOKEN,
        RDESC_NONTERMINAL,
        RDESC_SENTINEL,
};
 
struct rdesc_grammar_symbol {
        enum rdesc_grammar_symbol_type ty  ;
 
        int id  ;
};
 
 
#ifdef __cplusplus
extern "C" {
#endif
 
int rdesc_grammar_init(struct rdesc_grammar *grammar,
                       uint16_t production_count,
                       uint16_t max_alternative_count,
                       uint16_t max_alternative_size,
                       const struct rdesc_grammar_symbol *production_rules) _rdesc_wur;
 
void rdesc_grammar_destroy(struct rdesc_grammar *grammar);
 
/* Use with rdesc_grammar_init checked. */
int _rdesc_priv_grammar_init_checked(struct rdesc_grammar *,
                                     uint16_t, uint16_t, uint16_t,
                                     const struct rdesc_grammar_symbol *,
                                     int) _rdesc_wur;
#ifdef __cplusplus
}
#endif
 
 
#endif