1 //===---- llvm/Support/IRReader.h - Reader for LLVM IR files ----*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines functions for reading LLVM IR. They support both
11 // Bitcode and Assembly, automatically detecting the input format.
13 // These functions must be defined in a header file in order to avoid
14 // library dependencies, since they reference both Bitcode and Assembly
17 //===----------------------------------------------------------------------===//
19 #ifndef LLVM_SUPPORT_IRREADER_H
20 #define LLVM_SUPPORT_IRREADER_H
22 #include "llvm/ADT/OwningPtr.h"
23 #include "llvm/Assembly/Parser.h"
24 #include "llvm/Bitcode/ReaderWriter.h"
25 #include "llvm/Support/MemoryBuffer.h"
26 #include "llvm/Support/SourceMgr.h"
27 #include "llvm/Support/system_error.h"
31 /// If the given MemoryBuffer holds a bitcode image, return a Module for it
32 /// which does lazy deserialization of function bodies. Otherwise, attempt to
33 /// parse it as LLVM Assembly and return a fully populated Module. This
34 /// function *always* takes ownership of the given MemoryBuffer.
35 inline Module *getLazyIRModule(MemoryBuffer *Buffer,
37 LLVMContext &Context) {
38 if (isBitcode((const unsigned char *)Buffer->getBufferStart(),
39 (const unsigned char *)Buffer->getBufferEnd())) {
41 Module *M = getLazyBitcodeModule(Buffer, Context, &ErrMsg);
43 Err = SMDiagnostic(Buffer->getBufferIdentifier(), SourceMgr::DK_Error,
45 // ParseBitcodeFile does not take ownership of the Buffer in the
52 return ParseAssembly(Buffer, 0, Err, Context);
55 /// If the given file holds a bitcode image, return a Module
56 /// for it which does lazy deserialization of function bodies. Otherwise,
57 /// attempt to parse it as LLVM Assembly and return a fully populated
59 inline Module *getLazyIRFileModule(const std::string &Filename,
61 LLVMContext &Context) {
62 OwningPtr<MemoryBuffer> File;
63 if (error_code ec = MemoryBuffer::getFileOrSTDIN(Filename.c_str(), File)) {
64 Err = SMDiagnostic(Filename, SourceMgr::DK_Error,
65 "Could not open input file: " + ec.message());
69 return getLazyIRModule(File.take(), Err, Context);
72 /// If the given MemoryBuffer holds a bitcode image, return a Module
73 /// for it. Otherwise, attempt to parse it as LLVM Assembly and return
74 /// a Module for it. This function *always* takes ownership of the given
76 inline Module *ParseIR(MemoryBuffer *Buffer,
78 LLVMContext &Context) {
79 if (isBitcode((const unsigned char *)Buffer->getBufferStart(),
80 (const unsigned char *)Buffer->getBufferEnd())) {
82 Module *M = ParseBitcodeFile(Buffer, Context, &ErrMsg);
84 Err = SMDiagnostic(Buffer->getBufferIdentifier(), SourceMgr::DK_Error,
86 // ParseBitcodeFile does not take ownership of the Buffer.
91 return ParseAssembly(Buffer, 0, Err, Context);
94 /// If the given file holds a bitcode image, return a Module for it.
95 /// Otherwise, attempt to parse it as LLVM Assembly and return a Module
97 inline Module *ParseIRFile(const std::string &Filename,
99 LLVMContext &Context) {
100 OwningPtr<MemoryBuffer> File;
101 if (error_code ec = MemoryBuffer::getFileOrSTDIN(Filename.c_str(), File)) {
102 Err = SMDiagnostic(Filename, SourceMgr::DK_Error,
103 "Could not open input file: " + ec.message());
107 return ParseIR(File.take(), Err, Context);