class Statement;
struct Token;
+/**
+Frontend for loading datafiles. Handles switching between text and binary
+formats. A Parser evaluates into a boolean value indicating whether more
+statements may be read.
+*/
class Parser
{
-public:
- Parser(std::istream &, const std::string &);
- ~Parser();
-
- Statement parse();
- operator bool() const { return in; }
private:
Input in;
std::string src;
bool good;
ParserMode *mode;
+
+public:
+ Parser(std::istream &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.
+ */
+ Statement parse();
+
+ operator bool() const { return good && in; }
};
} // namespace DataFile