LLVM 20.0.0git
DbiModuleList.h
Go to the documentation of this file.
1//===- DbiModuleList.h - PDB module information list ------------*- C++ -*-===//
2//
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
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLVM_DEBUGINFO_PDB_NATIVE_DBIMODULELIST_H
10#define LLVM_DEBUGINFO_PDB_NATIVE_DBIMODULELIST_H
11
12#include "llvm/ADT/StringRef.h"
13#include "llvm/ADT/iterator.h"
18#include "llvm/Support/Endian.h"
19#include "llvm/Support/Error.h"
20#include <cstddef>
21#include <cstdint>
22#include <iterator>
23#include <vector>
24
25namespace llvm {
26namespace pdb {
27
28class DbiModuleList;
29struct FileInfoSubstreamHeader;
30
32 : public iterator_facade_base<DbiModuleSourceFilesIterator,
33 std::random_access_iterator_tag, StringRef> {
34 using BaseType = typename DbiModuleSourceFilesIterator::iterator_facade_base;
35
36public:
38 uint16_t Filei);
43
44 bool operator==(const DbiModuleSourceFilesIterator &R) const;
45
46 const StringRef &operator*() const { return ThisValue; }
47 StringRef &operator*() { return ThisValue; }
48
50 std::ptrdiff_t operator-(const DbiModuleSourceFilesIterator &R) const;
53
54private:
55 void setValue();
56
57 bool isEnd() const;
58 bool isCompatible(const DbiModuleSourceFilesIterator &R) const;
59 bool isUniversalEnd() const;
60
61 StringRef ThisValue;
62 const DbiModuleList *Modules{nullptr};
63 uint32_t Modi{0};
64 uint16_t Filei{0};
65};
66
69
70public:
72
77
79 source_files(uint32_t Modi) const;
80
82
83private:
84 Error initializeModInfo(BinaryStreamRef ModInfo);
85 Error initializeFileInfo(BinaryStreamRef FileInfo);
86
88
91
92 // For each module, there are multiple filenames, which can be obtained by
93 // knowing the index of the file. Given the index of the file, one can use
94 // that as an offset into the FileNameOffsets array, which contains the
95 // absolute offset of the file name in NamesBuffer. Thus, for each module
96 // we store the first index in the FileNameOffsets array for this module.
97 // The number of files for the corresponding module is stored in
98 // ModFileCountArray.
99 std::vector<uint32_t> ModuleInitialFileIndex;
100
101 // In order to provide random access into the Descriptors array, we iterate it
102 // once up front to find the offsets of the individual items and store them in
103 // this array.
104 std::vector<uint32_t> ModuleDescriptorOffsets;
105
106 const FileInfoSubstreamHeader *FileInfoHeader = nullptr;
107
108 BinaryStreamRef ModInfoSubstream;
109 BinaryStreamRef FileInfoSubstream;
110 BinaryStreamRef NamesBuffer;
111};
112
113} // end namespace pdb
114} // end namespace llvm
115
116#endif // LLVM_DEBUGINFO_PDB_NATIVE_DBIMODULELIST_H
Lightweight arrays that are backed by an arbitrary BinaryStream.
Value * RHS
BinaryStreamRef is to BinaryStream what ArrayRef is to an Array.
Lightweight error class with error context and mandatory checking.
Definition: Error.h:160
Tagged union holding either a T or a Error.
Definition: Error.h:481
FixedStreamArray is similar to VarStreamArray, except with each record having a fixed-length.
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
CRTP base class which implements the entire standard iterator facade in terms of a minimal subset of ...
Definition: iterator.h:80
A range adaptor for a pair of iterators.
DbiModuleDescriptor getModuleDescriptor(uint32_t Modi) const
uint32_t getModuleCount() const
Error initialize(BinaryStreamRef ModInfo, BinaryStreamRef FileInfo)
uint32_t getSourceFileCount() const
iterator_range< DbiModuleSourceFilesIterator > source_files(uint32_t Modi) const
Expected< StringRef > getFileName(uint32_t Index) const
DbiModuleSourceFilesIterator & operator-=(std::ptrdiff_t N)
std::ptrdiff_t operator-(const DbiModuleSourceFilesIterator &R) const
bool operator==(const DbiModuleSourceFilesIterator &R) const
DbiModuleSourceFilesIterator(const DbiModuleSourceFilesIterator &R)=default
DbiModuleSourceFilesIterator & operator+=(std::ptrdiff_t N)
const StringRef & operator*() const
Definition: DbiModuleList.h:46
bool operator<(const DbiModuleSourceFilesIterator &RHS) const
DbiModuleSourceFilesIterator & operator=(const DbiModuleSourceFilesIterator &R)=default
This provides a very simple, boring adaptor for a begin and end iterator into a range type.
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
#define N
The header preceding the File Info Substream of the DBI stream.
Definition: RawTypes.h:180