| //===- Parser.h - MLIR Parser Library Interface -----------------*- C++ -*-===// |
| // |
| // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
| // See https://llvm.org/LICENSE.txt for license information. |
| // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| // This file is contains the interface to the MLIR parser library. |
| // |
| //===----------------------------------------------------------------------===// |
| |
| #ifndef MLIR_PARSER_H |
| #define MLIR_PARSER_H |
| |
| #include <cstddef> |
| |
| namespace llvm { |
| class SourceMgr; |
| class SMDiagnostic; |
| class StringRef; |
| } // end namespace llvm |
| |
| namespace mlir { |
| class Attribute; |
| class Location; |
| class MLIRContext; |
| class OwningModuleRef; |
| class Type; |
| |
| /// This parses the file specified by the indicated SourceMgr and returns an |
| /// MLIR module if it was valid. If not, the error message is emitted through |
| /// the error handler registered in the context, and a null pointer is returned. |
| OwningModuleRef parseSourceFile(const llvm::SourceMgr &sourceMgr, |
| MLIRContext *context); |
| |
| /// This parses the file specified by the indicated filename and returns an |
| /// MLIR module if it was valid. If not, the error message is emitted through |
| /// the error handler registered in the context, and a null pointer is returned. |
| OwningModuleRef parseSourceFile(llvm::StringRef filename, MLIRContext *context); |
| |
| /// This parses the file specified by the indicated filename using the provided |
| /// SourceMgr and returns an MLIR module if it was valid. If not, the error |
| /// message is emitted through the error handler registered in the context, and |
| /// a null pointer is returned. |
| OwningModuleRef parseSourceFile(llvm::StringRef filename, |
| llvm::SourceMgr &sourceMgr, |
| MLIRContext *context); |
| |
| /// This parses the module string to a MLIR module if it was valid. If not, the |
| /// error message is emitted through the error handler registered in the |
| /// context, and a null pointer is returned. |
| OwningModuleRef parseSourceString(llvm::StringRef moduleStr, |
| MLIRContext *context); |
| |
| /// This parses a single MLIR attribute to an MLIR context if it was valid. If |
| /// not, an error message is emitted through a new SourceMgrDiagnosticHandler |
| /// constructed from a new SourceMgr with a single a MemoryBuffer wrapping |
| /// `attrStr`. If the passed `attrStr` has additional tokens that were not part |
| /// of the type, an error is emitted. |
| // TODO: Improve diagnostic reporting. |
| Attribute parseAttribute(llvm::StringRef attrStr, MLIRContext *context); |
| Attribute parseAttribute(llvm::StringRef attrStr, Type type); |
| |
| /// This parses a single MLIR attribute to an MLIR context if it was valid. If |
| /// not, an error message is emitted through a new SourceMgrDiagnosticHandler |
| /// constructed from a new SourceMgr with a single a MemoryBuffer wrapping |
| /// `attrStr`. The number of characters of `attrStr` parsed in the process is |
| /// returned in `numRead`. |
| Attribute parseAttribute(llvm::StringRef attrStr, MLIRContext *context, |
| size_t &numRead); |
| Attribute parseAttribute(llvm::StringRef attrStr, Type type, size_t &numRead); |
| |
| /// This parses a single MLIR type to an MLIR context if it was valid. If not, |
| /// an error message is emitted through a new SourceMgrDiagnosticHandler |
| /// constructed from a new SourceMgr with a single a MemoryBuffer wrapping |
| /// `typeStr`. If the passed `typeStr` has additional tokens that were not part |
| /// of the type, an error is emitted. |
| // TODO: Improve diagnostic reporting. |
| Type parseType(llvm::StringRef typeStr, MLIRContext *context); |
| |
| /// This parses a single MLIR type to an MLIR context if it was valid. If not, |
| /// an error message is emitted through a new SourceMgrDiagnosticHandler |
| /// constructed from a new SourceMgr with a single a MemoryBuffer wrapping |
| /// `typeStr`. The number of characters of `typeStr` parsed in the process is |
| /// returned in `numRead`. |
| Type parseType(llvm::StringRef typeStr, MLIRContext *context, size_t &numRead); |
| } // end namespace mlir |
| |
| #endif // MLIR_PARSER_H |