include/llvm/Assembly/Parser.h

   1 //===-- llvm/Assembly/Parser.h - Parser for VM assembly files ---*- C++ -*-===//
   2 //
   3 //  These classes are implemented by the lib/AsmParser library.
   4 //
   5 //===----------------------------------------------------------------------===//
   6
   7 #ifndef LLVM_ASSEMBLY_PARSER_H
   8 #define LLVM_ASSEMBLY_PARSER_H
   9
  10 #include <string>
  11
  12 class Module;
  13 class ParseException;
  14
  15
  16 // The useful interface defined by this file... Parse an ascii file, and return
  17 // the internal representation in a nice slice'n'dice'able representation.  Note
  18 // that this does not verify that the generated LLVM is valid, so you should run
  19 // the verifier after parsing the file to check that it's ok.
  20 //
  21 Module *ParseAssemblyFile(const std::string &Filename);// throw (ParseException)
  22
  23 //===------------------------------------------------------------------------===
  24 //                              Helper Classes
  25 //===------------------------------------------------------------------------===
  26
  27 // ParseException - For when an exceptional event is generated by the parser.
  28 // This class lets you print out the exception message
  29 //
  30 struct ParseException {
  31   ParseException(const std::string &filename, const std::string &message,
  32                  int LineNo = -1, int ColNo = -1);
  33
  34   ParseException(const ParseException &E);
  35
  36   // getMessage - Return the message passed in at construction time plus extra
  37   // information extracted from the options used to parse with...
  38   //
  39   const std::string getMessage() const;
  40
  41   inline const std::string &getRawMessage() const {   // Just the raw message...
  42     return Message;
  43   }
  44
  45   inline const std::string &getFilename() const {
  46     return Filename;
  47   }
  48
  49   // getErrorLocation - Return the line and column number of the error in the
  50   // input source file.  The source filename can be derived from the
  51   // ParserOptions in effect.  If positional information is not applicable,
  52   // these will return a value of -1.
  53   //
  54   inline const void getErrorLocation(int &Line, int &Column) const {
  55     Line = LineNo; Column = ColumnNo;
  56   }
  57
  58 private :
  59   std::string Filename;
  60   std::string Message;
  61   int LineNo, ColumnNo;                               // -1 if not relevant
  62
  63   ParseException &operator=(const ParseException &E); // objects by reference
  64 };
  65
  66 #endif