1 //===-- llvm/Remarks/Remark.h - The remark type -----------------*- C++/-*-===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
9 // This file provides an interface for parsing remarks in LLVM.
11 //===----------------------------------------------------------------------===//
13 #ifndef LLVM_REMARKS_REMARK_PARSER_H
14 #define LLVM_REMARKS_REMARK_PARSER_H
16 #include "llvm/ADT/SmallVector.h"
17 #include "llvm/ADT/StringRef.h"
18 #include "llvm/Remarks/Remark.h"
19 #include "llvm/Remarks/RemarkFormat.h"
20 #include "llvm/Support/Error.h"
26 class EndOfFileError
: public ErrorInfo
<EndOfFileError
> {
32 void log(raw_ostream
&OS
) const override
{ OS
<< "End of file reached."; }
33 std::error_code
convertToErrorCode() const override
{
34 return inconvertibleErrorCode();
38 /// Parser used to parse a raw buffer to remarks::Remark objects.
40 /// The format of the parser.
42 /// Path to prepend when opening an external remark file.
43 std::string ExternalFilePrependPath
;
45 RemarkParser(Format ParserFormat
) : ParserFormat(ParserFormat
) {}
47 /// If no error occurs, this returns a valid Remark object.
48 /// If an error of type EndOfFileError occurs, it is safe to recover from it
49 /// by stopping the parsing.
50 /// If any other error occurs, it should be propagated to the user.
51 /// The pointer should never be null.
52 virtual Expected
<std::unique_ptr
<Remark
>> next() = 0;
54 virtual ~RemarkParser() = default;
57 /// In-memory representation of the string table parsed from a buffer (e.g. the
59 struct ParsedStringTable
{
60 /// The buffer mapped from the section contents.
62 /// This object has high changes to be std::move'd around, so don't use a
63 /// SmallVector for once.
64 std::vector
<size_t> Offsets
;
66 ParsedStringTable(StringRef Buffer
);
68 ParsedStringTable(const ParsedStringTable
&) = delete;
69 ParsedStringTable
&operator=(const ParsedStringTable
&) = delete;
70 /// Should be movable.
71 ParsedStringTable(ParsedStringTable
&&) = default;
72 ParsedStringTable
&operator=(ParsedStringTable
&&) = default;
74 size_t size() const { return Offsets
.size(); }
75 Expected
<StringRef
> operator[](size_t Index
) const;
78 Expected
<std::unique_ptr
<RemarkParser
>> createRemarkParser(Format ParserFormat
,
81 Expected
<std::unique_ptr
<RemarkParser
>>
82 createRemarkParser(Format ParserFormat
, StringRef Buf
,
83 ParsedStringTable StrTab
);
85 Expected
<std::unique_ptr
<RemarkParser
>>
86 createRemarkParserFromMeta(Format ParserFormat
, StringRef Buf
,
87 Optional
<ParsedStringTable
> StrTab
= None
,
88 Optional
<StringRef
> ExternalFilePrependPath
= None
);
90 } // end namespace remarks
91 } // end namespace llvm
93 #endif /* LLVM_REMARKS_REMARK_PARSER_H */