1 //===- RecordIterator.h -----------------------------------------*- 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 #ifndef LLVM_DEBUGINFO_CODEVIEW_RECORDITERATOR_H
11 #define LLVM_DEBUGINFO_CODEVIEW_RECORDITERATOR_H
13 #include "llvm/ADT/ArrayRef.h"
14 #include "llvm/ADT/Optional.h"
15 #include "llvm/DebugInfo/CodeView/CodeViewError.h"
16 #include "llvm/DebugInfo/CodeView/RecordSerialization.h"
17 #include "llvm/DebugInfo/CodeView/TypeIndex.h"
18 #include "llvm/Support/BinaryStreamReader.h"
19 #include "llvm/Support/BinaryStreamRef.h"
20 #include "llvm/Support/Endian.h"
21 #include "llvm/Support/Error.h"
28 template <typename Kind> class CVRecord {
30 CVRecord() : Type(static_cast<Kind>(0)) {}
32 CVRecord(Kind K, ArrayRef<uint8_t> Data) : Type(K), RecordData(Data) {}
34 bool valid() const { return Type != static_cast<Kind>(0); }
36 uint32_t length() const { return RecordData.size(); }
37 Kind kind() const { return Type; }
38 ArrayRef<uint8_t> data() const { return RecordData; }
39 StringRef str_data() const {
40 return StringRef(reinterpret_cast<const char *>(RecordData.data()),
44 ArrayRef<uint8_t> content() const {
45 return RecordData.drop_front(sizeof(RecordPrefix));
48 Optional<uint32_t> hash() const { return Hash; }
50 void setHash(uint32_t Value) { Hash = Value; }
53 ArrayRef<uint8_t> RecordData;
54 Optional<uint32_t> Hash;
57 template <typename Kind> struct RemappedRecord {
58 explicit RemappedRecord(const CVRecord<Kind> &R) : OriginalRecord(R) {}
60 CVRecord<Kind> OriginalRecord;
61 SmallVector<std::pair<uint32_t, TypeIndex>, 8> Mappings;
64 /// Read a complete record from a stream at a random offset.
65 template <typename Kind>
66 inline Expected<CVRecord<Kind>> readCVRecordFromStream(BinaryStreamRef Stream,
68 const RecordPrefix *Prefix = nullptr;
69 BinaryStreamReader Reader(Stream);
70 Reader.setOffset(Offset);
72 if (auto EC = Reader.readObject(Prefix))
74 if (Prefix->RecordLen < 2)
75 return make_error<CodeViewError>(cv_error_code::corrupt_record);
76 Kind K = static_cast<Kind>(uint16_t(Prefix->RecordKind));
78 Reader.setOffset(Offset);
79 ArrayRef<uint8_t> RawData;
80 if (auto EC = Reader.readBytes(RawData, Prefix->RecordLen + sizeof(uint16_t)))
82 return codeview::CVRecord<Kind>(K, RawData);
85 } // end namespace codeview
87 template <typename Kind>
88 struct VarStreamArrayExtractor<codeview::CVRecord<Kind>> {
89 Error operator()(BinaryStreamRef Stream, uint32_t &Len,
90 codeview::CVRecord<Kind> &Item) {
91 auto ExpectedRec = codeview::readCVRecordFromStream<Kind>(Stream, 0);
93 return ExpectedRec.takeError();
95 Len = ExpectedRec->length();
96 return Error::success();
100 } // end namespace llvm
102 #endif // LLVM_DEBUGINFO_CODEVIEW_RECORDITERATOR_H