add API and backend hooks for iterative (chunked) parsing

This commit is contained in:
Sven M. Hallberg 2015-09-03 15:03:01 +02:00
parent e01d10f0ab
commit 2845a9391e
3 changed files with 99 additions and 1 deletions

View file

@ -210,10 +210,28 @@ struct HParseState_ {
HSlist *symbol_table; // its contents are HHashTables
};
struct HSuspendedParser_ {
HAllocator *mm__;
const HParser *parser;
void *backend_state;
// the only part of HInputStream that carries across chunks
uint8_t endianness;
};
typedef struct HParserBackendVTable_ {
int (*compile)(HAllocator *mm__, HParser* parser, const void* params);
HParseResult* (*parse)(HAllocator *mm__, const HParser* parser, HInputStream* stream);
void (*free)(HParser* parser);
void (*parse_start)(HSuspendedParser *s);
// parse_start should allocate backend_state.
void (*parse_chunk)(HSuspendedParser *s, HInputStream *input);
// when parse_chunk leaves input.overrun unset, parse is done. else:
// parse_chunk MUST consume all input, integrating it into backend_state.
// calling parse_chunk again after parse is done should have no effect.
HParseResult *(*parse_finish)(HSuspendedParser *s);
// parse_finish must free backend_state.
} HParserBackendVTable;