roland/xo-alloc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

xo-reader: tidy: + begin/end translation unit methods

Browse source
This commit is contained in:
Roland Conybeare 2024-08-06 10:11:36 -04:00
commit 0fdef0f317
2 changed files with 27 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

17
include/xo/parser/reader.hpp
View file

@ -31,6 +31,7 @@ namespace xo {
* Use:
* @code
* reader rdr;
* rdr.begin_translation_unit()
*
* bool eof = false;
* while (!eof) {
@ -63,6 +64,22 @@ namespace xo {
public:
reader() = default;
/** call once before calling .read_expr():
* 1. with new reader
* 2. if last read_expr() call had eof=true
**/
void begin_translation_unit();
/** counterpart to .begin_translation_unit(),
* provided for symmetry's sake
*
* Equivalent to:
* @code
* read_expr(span_type(nullptr, nullptr), true);
* @endcode
**/
reader_result end_translation_unit();
/** Try to read one expression from @p input.
* Return struct containing parsed expression
* and span of characters comprising that expression