]> git.tdb.fi Git - libs/datafile.git/blobdiff - source/parser.h
More efficient way of loading binary files
[libs/datafile.git] / source / parser.h
index 0989bd9d2d1fe378920c469c845f71435d799b28..243db1feb5fd186aa8eda14e93ad9a71bc5f113c 100644 (file)
@@ -7,8 +7,11 @@
 namespace Msp {
 namespace DataFile {
 
+class Loader;
+class LoaderAction;
 class ParserMode;
 class Statement;
+class StatementKey;
 
 /**
 Frontend for loading datafiles.  Handles switching between text and binary
@@ -28,18 +31,25 @@ public:
        Parser(IO::Base &i, const std::string &s);
        ~Parser();
 
-       /**
-       Reads a statement from the input.  If the end of input was reached, an empty
-       invalid statement will be returned.  If an error occurs, the parser will be
-       marked as bad and no more statements may be read, even if the exception was
-       caught.
-       */
+       /** Reads a statement from the input.  If the end of input was reached, an
+       empty invalid statement will be returned.  If an error occurs, the parser
+       will be marked as bad and no more statements may be read, even if the
+       exception was caught. */
        Statement parse(bool raw = false);
 
 private:
        void process_control_statement(const Statement &);
 
 public:
+       /** Returns a key for the next statement, consisting of its keyword and
+       signature.  Not supported in all modes. */
+       const StatementKey *peek(unsigned);
+
+       /** Parses a statement and feeds its arguments to an action.  The action
+       must be appropriate for the statement.  Use peek() to determine the
+       statement's signature. */
+       bool parse_and_load(unsigned, Loader &, const LoaderAction &);
+
        operator bool() const { return good && in; }
 };