//
// match.h - Header file for BP virtual machine.
//
#pragma once

#include <stdbool.h>
#include <stdio.h>
#include <sys/types.h>

#include "pattern.h"

//
// Pattern matching result object
//
typedef struct bp_match_s bp_match_t;
struct bp_match_s {
    // Where the match starts and ends (end is after the last character)
    const char *start, *end;
    bp_pat_t *pat;
    // Intrusive linked list node for garbage collection:
    struct {
        bp_match_t **home, *next;
    } gc;
    bp_match_t **children;
    bp_match_t *_children[3];
};

typedef void (*bp_errhand_t)(char **err_msg);

__attribute__((nonnull))
void recycle_match(bp_match_t **at_m);
size_t free_all_matches(void);
size_t recycle_all_matches(void);
bool next_match(bp_match_t **m, const char *start, const char *end, bp_pat_t *pat, bp_pat_t *defs, bp_pat_t *skip, bool ignorecase);
#define stop_matching(m) next_match(m, NULL, NULL, NULL, NULL, NULL, 0)
bp_errhand_t bp_set_error_handler(bp_errhand_t handler);
__attribute__((nonnull))
bp_match_t *get_numbered_capture(bp_match_t *m, int n);
__attribute__((nonnull, pure))
bp_match_t *get_named_capture(bp_match_t *m, const char *name, ssize_t namelen);

// vim: ts=4 sw=0 et cino=L2,l1,(0,W4,m1,\:0