--- /dev/null
+/** \file\r
+ * Base implementation of an ANTLR3 parser.\r
+ *\r
+ *\r
+ */\r
+#ifndef _ANTLR3_PARSER_H\r
+#define _ANTLR3_PARSER_H\r
+\r
+// [The "BSD licence"]\r
+// Copyright (c) 2005-2009 Jim Idle, Temporal Wave LLC\r
+// http://www.temporal-wave.com\r
+// http://www.linkedin.com/in/jimidle\r
+//\r
+// All rights reserved.\r
+//\r
+// Redistribution and use in source and binary forms, with or without\r
+// modification, are permitted provided that the following conditions\r
+// are met:\r
+// 1. Redistributions of source code must retain the above copyright\r
+// notice, this list of conditions and the following disclaimer.\r
+// 2. Redistributions in binary form must reproduce the above copyright\r
+// notice, this list of conditions and the following disclaimer in the\r
+// documentation and/or other materials provided with the distribution.\r
+// 3. The name of the author may not be used to endorse or promote products\r
+// derived from this software without specific prior written permission.\r
+//\r
+// THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR\r
+// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES\r
+// OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\r
+// IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,\r
+// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT\r
+// NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\r
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\r
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\r
+// THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
+\r
+#include <antlr3defs.h>\r
+#include <antlr3baserecognizer.h>\r
+\r
+#ifdef __cplusplus\r
+extern "C" {\r
+#endif\r
+\r
+/** This is the main interface for an ANTLR3 parser.\r
+ */\r
+typedef struct ANTLR3_PARSER_struct\r
+{\r
+ /** All superstructure implementers of this interface require a pointer to their selves,\r
+ * which they can reference using the super pointer here.\r
+ */\r
+ void * super;\r
+\r
+ /** A pointer to the base recognizer, where most of the parser functions actually\r
+ * live because they are shared between parser and tree parser and this is the\r
+ * easier way than copying the interface all over the place. Macros hide this\r
+ * for the generated code so it is easier on the eye (though not the debugger ;-).\r
+ */\r
+ pANTLR3_BASE_RECOGNIZER rec;\r
+\r
+ /** A provider of a tokenstream interface, for the parser to consume\r
+ * tokens from.\r
+ */\r
+ pANTLR3_TOKEN_STREAM tstream;\r
+\r
+ /** A pointer to a function that installs a debugger object (it also\r
+ * installs the debugging versions of the parser methods. This means that \r
+ * a non debug parser incurs no overhead because of the debugging stuff.\r
+ */\r
+ void (*setDebugListener) (struct ANTLR3_PARSER_struct * parser, pANTLR3_DEBUG_EVENT_LISTENER dbg);\r
+\r
+ /** A pointer to a function that installs a token stream \r
+ * for the parser.\r
+ */\r
+ void (*setTokenStream) (struct ANTLR3_PARSER_struct * parser, pANTLR3_TOKEN_STREAM);\r
+\r
+ /** A pointer to a function that returns the token stream for this \r
+ * parser.\r
+ */\r
+ pANTLR3_TOKEN_STREAM (*getTokenStream) (struct ANTLR3_PARSER_struct * parser);\r
+\r
+ /** Pointer to a function that knows how to free resources of an ANTLR3 parser.\r
+ */\r
+ void (*free) (struct ANTLR3_PARSER_struct * parser);\r
+\r
+}\r
+ ANTLR3_PARSER;\r
+\r
+#ifdef __cplusplus\r
+}\r
+#endif\r
+\r
+#endif\r