Bug Summary

File:lib/DebugInfo/CodeView/SymbolRecordMapping.cpp
Warning:line 106, column 30
The right operand of '<' is a garbage value

Annotated Source Code

Press '?' to see keyboard shortcuts

clang -cc1 -triple x86_64-pc-linux-gnu -analyze -disable-free -disable-llvm-verifier -discard-value-names -main-file-name SymbolRecordMapping.cpp -analyzer-store=region -analyzer-opt-analyze-nested-blocks -analyzer-eagerly-assume -analyzer-checker=core -analyzer-checker=apiModeling -analyzer-checker=unix -analyzer-checker=deadcode -analyzer-checker=cplusplus -analyzer-checker=security.insecureAPI.UncheckedReturn -analyzer-checker=security.insecureAPI.getpw -analyzer-checker=security.insecureAPI.gets -analyzer-checker=security.insecureAPI.mktemp -analyzer-checker=security.insecureAPI.mkstemp -analyzer-checker=security.insecureAPI.vfork -analyzer-checker=nullability.NullPassedToNonnull -analyzer-checker=nullability.NullReturnedFromNonnull -analyzer-output plist -w -mrelocation-model pic -pic-level 2 -mthread-model posix -fmath-errno -masm-verbose -mconstructor-aliases -munwind-tables -fuse-init-array -target-cpu x86-64 -dwarf-column-info -debugger-tuning=gdb -momit-leaf-frame-pointer -ffunction-sections -fdata-sections -resource-dir /usr/lib/llvm-7/lib/clang/7.0.0 -D _DEBUG -D _GNU_SOURCE -D __STDC_CONSTANT_MACROS -D __STDC_FORMAT_MACROS -D __STDC_LIMIT_MACROS -I /build/llvm-toolchain-snapshot-7~svn326246/build-llvm/lib/DebugInfo/CodeView -I /build/llvm-toolchain-snapshot-7~svn326246/lib/DebugInfo/CodeView -I /build/llvm-toolchain-snapshot-7~svn326246/build-llvm/include -I /build/llvm-toolchain-snapshot-7~svn326246/include -U NDEBUG -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/7.3.0/../../../../include/c++/7.3.0 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/7.3.0/../../../../include/x86_64-linux-gnu/c++/7.3.0 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/7.3.0/../../../../include/x86_64-linux-gnu/c++/7.3.0 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/7.3.0/../../../../include/c++/7.3.0/backward -internal-isystem /usr/include/clang/7.0.0/include/ -internal-isystem /usr/local/include -internal-isystem /usr/lib/llvm-7/lib/clang/7.0.0/include -internal-externc-isystem /usr/include/x86_64-linux-gnu -internal-externc-isystem /include -internal-externc-isystem /usr/include -O2 -Wno-unused-parameter -Wwrite-strings -Wno-missing-field-initializers -Wno-long-long -Wno-maybe-uninitialized -Wno-comment -std=c++11 -fdeprecated-macro -fdebug-compilation-dir /build/llvm-toolchain-snapshot-7~svn326246/build-llvm/lib/DebugInfo/CodeView -ferror-limit 19 -fmessage-length 0 -fvisibility-inlines-hidden -fobjc-runtime=gcc -fdiagnostics-show-option -vectorize-loops -vectorize-slp -analyzer-checker optin.performance.Padding -analyzer-output=html -analyzer-config stable-report-filename=true -o /tmp/scan-build-2018-02-28-041547-14988-1 -x c++ /build/llvm-toolchain-snapshot-7~svn326246/lib/DebugInfo/CodeView/SymbolRecordMapping.cpp

/build/llvm-toolchain-snapshot-7~svn326246/lib/DebugInfo/CodeView/SymbolRecordMapping.cpp

→
1//===- SymbolRecordMapping.cpp -----------------------------------*- C++-*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9
10#include "llvm/DebugInfo/CodeView/SymbolRecordMapping.h"
11
12using namespace llvm;
13using namespace llvm::codeview;
14
15#define error(X)if (auto EC = X) return EC; \
16 if (auto EC = X) \
17 return EC;
18
19namespace {
20struct MapGap {
21 Error operator()(CodeViewRecordIO &IO, LocalVariableAddrGap &Gap) const {
22 error(IO.mapInteger(Gap.GapStartOffset))if (auto EC = IO.mapInteger(Gap.GapStartOffset)) return EC;;
23 error(IO.mapInteger(Gap.Range))if (auto EC = IO.mapInteger(Gap.Range)) return EC;;
24 return Error::success();
25 }
26};
27}
28
29static Error mapLocalVariableAddrRange(CodeViewRecordIO &IO,
30 LocalVariableAddrRange &Range) {
31 error(IO.mapInteger(Range.OffsetStart))if (auto EC = IO.mapInteger(Range.OffsetStart)) return EC;;
32 error(IO.mapInteger(Range.ISectStart))if (auto EC = IO.mapInteger(Range.ISectStart)) return EC;;
33 error(IO.mapInteger(Range.Range))if (auto EC = IO.mapInteger(Range.Range)) return EC;;
34 return Error::success();
35}
36
37Error SymbolRecordMapping::visitSymbolBegin(CVSymbol &Record) {
38 error(IO.beginRecord(MaxRecordLength - sizeof(RecordPrefix)))if (auto EC = IO.beginRecord(MaxRecordLength - sizeof(RecordPrefix
))) return EC;;
39 return Error::success();
40}
41
42Error SymbolRecordMapping::visitSymbolEnd(CVSymbol &Record) {
43 error(IO.padToAlignment(alignOf(Container)))if (auto EC = IO.padToAlignment(alignOf(Container))) return EC
;;
44 error(IO.endRecord())if (auto EC = IO.endRecord()) return EC;;
45 return Error::success();
46}
47
48Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, BlockSym &Block) {
49
50 error(IO.mapInteger(Block.Parent))if (auto EC = IO.mapInteger(Block.Parent)) return EC;;
51 error(IO.mapInteger(Block.End))if (auto EC = IO.mapInteger(Block.End)) return EC;;
52 error(IO.mapInteger(Block.CodeSize))if (auto EC = IO.mapInteger(Block.CodeSize)) return EC;;
53 error(IO.mapInteger(Block.CodeOffset))if (auto EC = IO.mapInteger(Block.CodeOffset)) return EC;;
54 error(IO.mapInteger(Block.Segment))if (auto EC = IO.mapInteger(Block.Segment)) return EC;;
55 error(IO.mapStringZ(Block.Name))if (auto EC = IO.mapStringZ(Block.Name)) return EC;;
56
57 return Error::success();
58}
59
60Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, Thunk32Sym &Thunk) {
61
62 error(IO.mapInteger(Thunk.Parent))if (auto EC = IO.mapInteger(Thunk.Parent)) return EC;;
63 error(IO.mapInteger(Thunk.End))if (auto EC = IO.mapInteger(Thunk.End)) return EC;;
64 error(IO.mapInteger(Thunk.Next))if (auto EC = IO.mapInteger(Thunk.Next)) return EC;;
65 error(IO.mapInteger(Thunk.Offset))if (auto EC = IO.mapInteger(Thunk.Offset)) return EC;;
66 error(IO.mapInteger(Thunk.Segment))if (auto EC = IO.mapInteger(Thunk.Segment)) return EC;;
67 error(IO.mapInteger(Thunk.Length))if (auto EC = IO.mapInteger(Thunk.Length)) return EC;;
68 error(IO.mapEnum(Thunk.Thunk))if (auto EC = IO.mapEnum(Thunk.Thunk)) return EC;;
69 error(IO.mapStringZ(Thunk.Name))if (auto EC = IO.mapStringZ(Thunk.Name)) return EC;;
70 error(IO.mapByteVectorTail(Thunk.VariantData))if (auto EC = IO.mapByteVectorTail(Thunk.VariantData)) return
EC;;
71
72 return Error::success();
73}
74
75Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
76 TrampolineSym &Tramp) {
77
78 error(IO.mapEnum(Tramp.Type))if (auto EC = IO.mapEnum(Tramp.Type)) return EC;;
79 error(IO.mapInteger(Tramp.Size))if (auto EC = IO.mapInteger(Tramp.Size)) return EC;;
80 error(IO.mapInteger(Tramp.ThunkOffset))if (auto EC = IO.mapInteger(Tramp.ThunkOffset)) return EC;;
81 error(IO.mapInteger(Tramp.TargetOffset))if (auto EC = IO.mapInteger(Tramp.TargetOffset)) return EC;;
82 error(IO.mapInteger(Tramp.ThunkSection))if (auto EC = IO.mapInteger(Tramp.ThunkSection)) return EC;;
83 error(IO.mapInteger(Tramp.TargetSection))if (auto EC = IO.mapInteger(Tramp.TargetSection)) return EC;;
84
85 return Error::success();
86}
87
88Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
89 SectionSym &Section) {
90 uint8_t Padding = 0;
91
92 error(IO.mapInteger(Section.SectionNumber))if (auto EC = IO.mapInteger(Section.SectionNumber)) return EC
;;
93 error(IO.mapInteger(Section.Alignment))if (auto EC = IO.mapInteger(Section.Alignment)) return EC;;
94 error(IO.mapInteger(Padding))if (auto EC = IO.mapInteger(Padding)) return EC;;
95 error(IO.mapInteger(Section.Rva))if (auto EC = IO.mapInteger(Section.Rva)) return EC;;
96 error(IO.mapInteger(Section.Length))if (auto EC = IO.mapInteger(Section.Length)) return EC;;
97 error(IO.mapInteger(Section.Characteristics))if (auto EC = IO.mapInteger(Section.Characteristics)) return EC
;;
98 error(IO.mapStringZ(Section.Name))if (auto EC = IO.mapStringZ(Section.Name)) return EC;;
99
100 return Error::success();
101}
102
103Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
104 CoffGroupSym &CoffGroup) {
105
106 error(IO.mapInteger(CoffGroup.Size))if (auto EC = IO.mapInteger(CoffGroup.Size)) return EC;;
107 error(IO.mapInteger(CoffGroup.Characteristics))if (auto EC = IO.mapInteger(CoffGroup.Characteristics)) return
EC;;
108 error(IO.mapInteger(CoffGroup.Offset))if (auto EC = IO.mapInteger(CoffGroup.Offset)) return EC;;
109 error(IO.mapInteger(CoffGroup.Segment))if (auto EC = IO.mapInteger(CoffGroup.Segment)) return EC;;
110 error(IO.mapStringZ(CoffGroup.Name))if (auto EC = IO.mapStringZ(CoffGroup.Name)) return EC;;
111
112 return Error::success();
113}
114
115Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
116 BPRelativeSym &BPRel) {
117
118 error(IO.mapInteger(BPRel.Offset))if (auto EC = IO.mapInteger(BPRel.Offset)) return EC;;
119 error(IO.mapInteger(BPRel.Type))if (auto EC = IO.mapInteger(BPRel.Type)) return EC;;
120 error(IO.mapStringZ(BPRel.Name))if (auto EC = IO.mapStringZ(BPRel.Name)) return EC;;
121
122 return Error::success();
123}
124
125Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
126 BuildInfoSym &BuildInfo) {
127
128 error(IO.mapInteger(BuildInfo.BuildId))if (auto EC = IO.mapInteger(BuildInfo.BuildId)) return EC;;
129
130 return Error::success();
131}
132
133Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
134 CallSiteInfoSym &CallSiteInfo) {
135 uint16_t Padding = 0;
136
137 error(IO.mapInteger(CallSiteInfo.CodeOffset))if (auto EC = IO.mapInteger(CallSiteInfo.CodeOffset)) return EC
;;
138 error(IO.mapInteger(CallSiteInfo.Segment))if (auto EC = IO.mapInteger(CallSiteInfo.Segment)) return EC;;
139 error(IO.mapInteger(Padding))if (auto EC = IO.mapInteger(Padding)) return EC;;
140 error(IO.mapInteger(CallSiteInfo.Type))if (auto EC = IO.mapInteger(CallSiteInfo.Type)) return EC;;
141
142 return Error::success();
143}
144
145Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
146 EnvBlockSym &EnvBlock) {
147
148 uint8_t Reserved = 0;
149 error(IO.mapInteger(Reserved))if (auto EC = IO.mapInteger(Reserved)) return EC;;
150 error(IO.mapStringZVectorZ(EnvBlock.Fields))if (auto EC = IO.mapStringZVectorZ(EnvBlock.Fields)) return EC
;;
151
152 return Error::success();
153}
154
155Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
156 FileStaticSym &FileStatic) {
157
158 error(IO.mapInteger(FileStatic.Index))if (auto EC = IO.mapInteger(FileStatic.Index)) return EC;;
159 error(IO.mapInteger(FileStatic.ModFilenameOffset))if (auto EC = IO.mapInteger(FileStatic.ModFilenameOffset)) return
EC;;
160 error(IO.mapEnum(FileStatic.Flags))if (auto EC = IO.mapEnum(FileStatic.Flags)) return EC;;
161 error(IO.mapStringZ(FileStatic.Name))if (auto EC = IO.mapStringZ(FileStatic.Name)) return EC;;
162
163 return Error::success();
164}
165
166Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, ExportSym &Export) {
167
168 error(IO.mapInteger(Export.Ordinal))if (auto EC = IO.mapInteger(Export.Ordinal)) return EC;;
169 error(IO.mapEnum(Export.Flags))if (auto EC = IO.mapEnum(Export.Flags)) return EC;;
170 error(IO.mapStringZ(Export.Name))if (auto EC = IO.mapStringZ(Export.Name)) return EC;;
171
172 return Error::success();
173}
174
175Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
176 Compile2Sym &Compile2) {
177
178 error(IO.mapEnum(Compile2.Flags))if (auto EC = IO.mapEnum(Compile2.Flags)) return EC;;
179 error(IO.mapEnum(Compile2.Machine))if (auto EC = IO.mapEnum(Compile2.Machine)) return EC;;
180 error(IO.mapInteger(Compile2.VersionFrontendMajor))if (auto EC = IO.mapInteger(Compile2.VersionFrontendMajor)) return
EC;;
181 error(IO.mapInteger(Compile2.VersionFrontendMinor))if (auto EC = IO.mapInteger(Compile2.VersionFrontendMinor)) return
EC;;
182 error(IO.mapInteger(Compile2.VersionFrontendBuild))if (auto EC = IO.mapInteger(Compile2.VersionFrontendBuild)) return
EC;;
183 error(IO.mapInteger(Compile2.VersionBackendMajor))if (auto EC = IO.mapInteger(Compile2.VersionBackendMajor)) return
EC;;
184 error(IO.mapInteger(Compile2.VersionBackendMinor))if (auto EC = IO.mapInteger(Compile2.VersionBackendMinor)) return
EC;;
185 error(IO.mapInteger(Compile2.VersionBackendBuild))if (auto EC = IO.mapInteger(Compile2.VersionBackendBuild)) return
EC;;
186 error(IO.mapStringZ(Compile2.Version))if (auto EC = IO.mapStringZ(Compile2.Version)) return EC;;
187 error(IO.mapStringZVectorZ(Compile2.ExtraStrings))if (auto EC = IO.mapStringZVectorZ(Compile2.ExtraStrings)) return
EC;;
188
189 return Error::success();
190}
191
192Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
193 Compile3Sym &Compile3) {
194
195 error(IO.mapEnum(Compile3.Flags))if (auto EC = IO.mapEnum(Compile3.Flags)) return EC;;
196 error(IO.mapEnum(Compile3.Machine))if (auto EC = IO.mapEnum(Compile3.Machine)) return EC;;
197 error(IO.mapInteger(Compile3.VersionFrontendMajor))if (auto EC = IO.mapInteger(Compile3.VersionFrontendMajor)) return
EC;;
198 error(IO.mapInteger(Compile3.VersionFrontendMinor))if (auto EC = IO.mapInteger(Compile3.VersionFrontendMinor)) return
EC;;
199 error(IO.mapInteger(Compile3.VersionFrontendBuild))if (auto EC = IO.mapInteger(Compile3.VersionFrontendBuild)) return
EC;;
200 error(IO.mapInteger(Compile3.VersionFrontendQFE))if (auto EC = IO.mapInteger(Compile3.VersionFrontendQFE)) return
EC;;
201 error(IO.mapInteger(Compile3.VersionBackendMajor))if (auto EC = IO.mapInteger(Compile3.VersionBackendMajor)) return
EC;;
202 error(IO.mapInteger(Compile3.VersionBackendMinor))if (auto EC = IO.mapInteger(Compile3.VersionBackendMinor)) return
EC;;
203 error(IO.mapInteger(Compile3.VersionBackendBuild))if (auto EC = IO.mapInteger(Compile3.VersionBackendBuild)) return
EC;;
204 error(IO.mapInteger(Compile3.VersionBackendQFE))if (auto EC = IO.mapInteger(Compile3.VersionBackendQFE)) return
EC;;
205 error(IO.mapStringZ(Compile3.Version))if (auto EC = IO.mapStringZ(Compile3.Version)) return EC;;
206
207 return Error::success();
208}
209
210Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
211 ConstantSym &Constant) {
212
213 error(IO.mapInteger(Constant.Type))if (auto EC = IO.mapInteger(Constant.Type)) return EC;;
214 error(IO.mapEncodedInteger(Constant.Value))if (auto EC = IO.mapEncodedInteger(Constant.Value)) return EC
;;
215 error(IO.mapStringZ(Constant.Name))if (auto EC = IO.mapStringZ(Constant.Name)) return EC;;
216
217 return Error::success();
218}
219
220Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, DataSym &Data) {
221
222 error(IO.mapInteger(Data.Type))if (auto EC = IO.mapInteger(Data.Type)) return EC;;
223 error(IO.mapInteger(Data.DataOffset))if (auto EC = IO.mapInteger(Data.DataOffset)) return EC;;
224 error(IO.mapInteger(Data.Segment))if (auto EC = IO.mapInteger(Data.Segment)) return EC;;
225 error(IO.mapStringZ(Data.Name))if (auto EC = IO.mapStringZ(Data.Name)) return EC;;
226
227 return Error::success();
228}
229
230Error SymbolRecordMapping::visitKnownRecord(
231 CVSymbol &CVR, DefRangeFramePointerRelSym &DefRangeFramePointerRel) {
232
233 error(IO.mapInteger(DefRangeFramePointerRel.Offset))if (auto EC = IO.mapInteger(DefRangeFramePointerRel.Offset)) return
EC;;
234 error(mapLocalVariableAddrRange(IO, DefRangeFramePointerRel.Range))if (auto EC = mapLocalVariableAddrRange(IO, DefRangeFramePointerRel
.Range)) return EC;;
235 error(IO.mapVectorTail(DefRangeFramePointerRel.Gaps, MapGap()))if (auto EC = IO.mapVectorTail(DefRangeFramePointerRel.Gaps, MapGap
())) return EC;;
236
237 return Error::success();
238}
239
240Error SymbolRecordMapping::visitKnownRecord(
241 CVSymbol &CVR,
242 DefRangeFramePointerRelFullScopeSym &DefRangeFramePointerRelFullScope) {
243
244 error(IO.mapInteger(DefRangeFramePointerRelFullScope.Offset))if (auto EC = IO.mapInteger(DefRangeFramePointerRelFullScope.
Offset)) return EC;;
245
246 return Error::success();
247}
248
249Error SymbolRecordMapping::visitKnownRecord(
250 CVSymbol &CVR, DefRangeRegisterRelSym &DefRangeRegisterRel) {
251
252 error(IO.mapObject(DefRangeRegisterRel.Hdr.Register))if (auto EC = IO.mapObject(DefRangeRegisterRel.Hdr.Register))
return EC;;
253 error(IO.mapObject(DefRangeRegisterRel.Hdr.Flags))if (auto EC = IO.mapObject(DefRangeRegisterRel.Hdr.Flags)) return
EC;;
254 error(IO.mapObject(DefRangeRegisterRel.Hdr.BasePointerOffset))if (auto EC = IO.mapObject(DefRangeRegisterRel.Hdr.BasePointerOffset
)) return EC;;
255 error(mapLocalVariableAddrRange(IO, DefRangeRegisterRel.Range))if (auto EC = mapLocalVariableAddrRange(IO, DefRangeRegisterRel
.Range)) return EC;;
256 error(IO.mapVectorTail(DefRangeRegisterRel.Gaps, MapGap()))if (auto EC = IO.mapVectorTail(DefRangeRegisterRel.Gaps, MapGap
())) return EC;;
257
258 return Error::success();
259}
260
261Error SymbolRecordMapping::visitKnownRecord(
262 CVSymbol &CVR, DefRangeRegisterSym &DefRangeRegister) {
263
264 error(IO.mapObject(DefRangeRegister.Hdr.Register))if (auto EC = IO.mapObject(DefRangeRegister.Hdr.Register)) return
EC;;
265 error(IO.mapObject(DefRangeRegister.Hdr.MayHaveNoName))if (auto EC = IO.mapObject(DefRangeRegister.Hdr.MayHaveNoName
)) return EC;;
266 error(mapLocalVariableAddrRange(IO, DefRangeRegister.Range))if (auto EC = mapLocalVariableAddrRange(IO, DefRangeRegister.
Range)) return EC;;
267 error(IO.mapVectorTail(DefRangeRegister.Gaps, MapGap()))if (auto EC = IO.mapVectorTail(DefRangeRegister.Gaps, MapGap(
))) return EC;;
268
269 return Error::success();
270}
271
272Error SymbolRecordMapping::visitKnownRecord(
273 CVSymbol &CVR, DefRangeSubfieldRegisterSym &DefRangeSubfieldRegister) {
274
275 error(IO.mapObject(DefRangeSubfieldRegister.Hdr.Register))if (auto EC = IO.mapObject(DefRangeSubfieldRegister.Hdr.Register
)) return EC;;
276 error(IO.mapObject(DefRangeSubfieldRegister.Hdr.MayHaveNoName))if (auto EC = IO.mapObject(DefRangeSubfieldRegister.Hdr.MayHaveNoName
)) return EC;;
277 error(IO.mapObject(DefRangeSubfieldRegister.Hdr.OffsetInParent))if (auto EC = IO.mapObject(DefRangeSubfieldRegister.Hdr.OffsetInParent
)) return EC;;
278 error(mapLocalVariableAddrRange(IO, DefRangeSubfieldRegister.Range))if (auto EC = mapLocalVariableAddrRange(IO, DefRangeSubfieldRegister
.Range)) return EC;;
279 error(IO.mapVectorTail(DefRangeSubfieldRegister.Gaps, MapGap()))if (auto EC = IO.mapVectorTail(DefRangeSubfieldRegister.Gaps,
MapGap())) return EC;;
280
281 return Error::success();
282}
283
284Error SymbolRecordMapping::visitKnownRecord(
285 CVSymbol &CVR, DefRangeSubfieldSym &DefRangeSubfield) {
286
287 error(IO.mapInteger(DefRangeSubfield.Program))if (auto EC = IO.mapInteger(DefRangeSubfield.Program)) return
EC;;
288 error(IO.mapInteger(DefRangeSubfield.OffsetInParent))if (auto EC = IO.mapInteger(DefRangeSubfield.OffsetInParent))
return EC;;
289 error(mapLocalVariableAddrRange(IO, DefRangeSubfield.Range))if (auto EC = mapLocalVariableAddrRange(IO, DefRangeSubfield.
Range)) return EC;;
290 error(IO.mapVectorTail(DefRangeSubfield.Gaps, MapGap()))if (auto EC = IO.mapVectorTail(DefRangeSubfield.Gaps, MapGap(
))) return EC;;
291
292 return Error::success();
293}
294
295Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
296 DefRangeSym &DefRange) {
297
298 error(IO.mapInteger(DefRange.Program))if (auto EC = IO.mapInteger(DefRange.Program)) return EC;;
299 error(mapLocalVariableAddrRange(IO, DefRange.Range))if (auto EC = mapLocalVariableAddrRange(IO, DefRange.Range)) return
EC;;
300 error(IO.mapVectorTail(DefRange.Gaps, MapGap()))if (auto EC = IO.mapVectorTail(DefRange.Gaps, MapGap())) return
EC;;
301
302 return Error::success();
303}
304
305Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
306 FrameCookieSym &FrameCookie) {
307
308 error(IO.mapInteger(FrameCookie.CodeOffset))if (auto EC = IO.mapInteger(FrameCookie.CodeOffset)) return EC
;;
309 error(IO.mapInteger(FrameCookie.Register))if (auto EC = IO.mapInteger(FrameCookie.Register)) return EC;;
310 error(IO.mapEnum(FrameCookie.CookieKind))if (auto EC = IO.mapEnum(FrameCookie.CookieKind)) return EC;;
311 error(IO.mapInteger(FrameCookie.Flags))if (auto EC = IO.mapInteger(FrameCookie.Flags)) return EC;;
312
313 return Error::success();
314}
315
316Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
317 FrameProcSym &FrameProc) {
318 error(IO.mapInteger(FrameProc.TotalFrameBytes))if (auto EC = IO.mapInteger(FrameProc.TotalFrameBytes)) return
EC;;
319 error(IO.mapInteger(FrameProc.PaddingFrameBytes))if (auto EC = IO.mapInteger(FrameProc.PaddingFrameBytes)) return
EC;;
320 error(IO.mapInteger(FrameProc.OffsetToPadding))if (auto EC = IO.mapInteger(FrameProc.OffsetToPadding)) return
EC;;
321 error(IO.mapInteger(FrameProc.BytesOfCalleeSavedRegisters))if (auto EC = IO.mapInteger(FrameProc.BytesOfCalleeSavedRegisters
)) return EC;;
322 error(IO.mapInteger(FrameProc.OffsetOfExceptionHandler))if (auto EC = IO.mapInteger(FrameProc.OffsetOfExceptionHandler
)) return EC;;
323 error(IO.mapInteger(FrameProc.SectionIdOfExceptionHandler))if (auto EC = IO.mapInteger(FrameProc.SectionIdOfExceptionHandler
)) return EC;;
324 error(IO.mapEnum(FrameProc.Flags))if (auto EC = IO.mapEnum(FrameProc.Flags)) return EC;;
325
326 return Error::success();
327}
328
329Error SymbolRecordMapping::visitKnownRecord(
330 CVSymbol &CVR, HeapAllocationSiteSym &HeapAllocSite) {
331
332 error(IO.mapInteger(HeapAllocSite.CodeOffset))if (auto EC = IO.mapInteger(HeapAllocSite.CodeOffset)) return
EC;;
333 error(IO.mapInteger(HeapAllocSite.Segment))if (auto EC = IO.mapInteger(HeapAllocSite.Segment)) return EC
;;
334 error(IO.mapInteger(HeapAllocSite.CallInstructionSize))if (auto EC = IO.mapInteger(HeapAllocSite.CallInstructionSize
)) return EC;;
335 error(IO.mapInteger(HeapAllocSite.Type))if (auto EC = IO.mapInteger(HeapAllocSite.Type)) return EC;;
336
337 return Error::success();
338}
339
340Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
341 InlineSiteSym &InlineSite) {
342
343 error(IO.mapInteger(InlineSite.Parent))if (auto EC = IO.mapInteger(InlineSite.Parent)) return EC;;
344 error(IO.mapInteger(InlineSite.End))if (auto EC = IO.mapInteger(InlineSite.End)) return EC;;
345 error(IO.mapInteger(InlineSite.Inlinee))if (auto EC = IO.mapInteger(InlineSite.Inlinee)) return EC;;
346 error(IO.mapByteVectorTail(InlineSite.AnnotationData))if (auto EC = IO.mapByteVectorTail(InlineSite.AnnotationData)
) return EC;;
347
348 return Error::success();
349}
350
351Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
352 RegisterSym &Register) {
353
354 error(IO.mapInteger(Register.Index))if (auto EC = IO.mapInteger(Register.Index)) return EC;;
355 error(IO.mapEnum(Register.Register))if (auto EC = IO.mapEnum(Register.Register)) return EC;;
356 error(IO.mapStringZ(Register.Name))if (auto EC = IO.mapStringZ(Register.Name)) return EC;;
357
358 return Error::success();
359}
360
361Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
362 PublicSym32 &Public) {
363
364 error(IO.mapEnum(Public.Flags))if (auto EC = IO.mapEnum(Public.Flags)) return EC;;
365 error(IO.mapInteger(Public.Offset))if (auto EC = IO.mapInteger(Public.Offset)) return EC;;
366 error(IO.mapInteger(Public.Segment))if (auto EC = IO.mapInteger(Public.Segment)) return EC;;
367 error(IO.mapStringZ(Public.Name))if (auto EC = IO.mapStringZ(Public.Name)) return EC;;
368
369 return Error::success();
370}
371
372Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
373 ProcRefSym &ProcRef) {
374
375 error(IO.mapInteger(ProcRef.SumName))if (auto EC = IO.mapInteger(ProcRef.SumName)) return EC;;
376 error(IO.mapInteger(ProcRef.SymOffset))if (auto EC = IO.mapInteger(ProcRef.SymOffset)) return EC;;
377 error(IO.mapInteger(ProcRef.Module))if (auto EC = IO.mapInteger(ProcRef.Module)) return EC;;
378 error(IO.mapStringZ(ProcRef.Name))if (auto EC = IO.mapStringZ(ProcRef.Name)) return EC;;
379
380 return Error::success();
381}
382
383Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, LabelSym &Label) {
384
385 error(IO.mapInteger(Label.CodeOffset))if (auto EC = IO.mapInteger(Label.CodeOffset)) return EC;;
386 error(IO.mapInteger(Label.Segment))if (auto EC = IO.mapInteger(Label.Segment)) return EC;;
387 error(IO.mapEnum(Label.Flags))if (auto EC = IO.mapEnum(Label.Flags)) return EC;;
388 error(IO.mapStringZ(Label.Name))if (auto EC = IO.mapStringZ(Label.Name)) return EC;;
389
390 return Error::success();
391}
392
393Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, LocalSym &Local) {
394 error(IO.mapInteger(Local.Type))if (auto EC = IO.mapInteger(Local.Type)) return EC;;
395 error(IO.mapEnum(Local.Flags))if (auto EC = IO.mapEnum(Local.Flags)) return EC;;
396 error(IO.mapStringZ(Local.Name))if (auto EC = IO.mapStringZ(Local.Name)) return EC;;
397
398 return Error::success();
399}
400
401Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
402 ObjNameSym &ObjName) {
403
404 error(IO.mapInteger(ObjName.Signature))if (auto EC = IO.mapInteger(ObjName.Signature)) return EC;;
405 error(IO.mapStringZ(ObjName.Name))if (auto EC = IO.mapStringZ(ObjName.Name)) return EC;;
406
407 return Error::success();
408}
409
410Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, ProcSym &Proc) {
411 error(IO.mapInteger(Proc.Parent))if (auto EC = IO.mapInteger(Proc.Parent)) return EC;;
412 error(IO.mapInteger(Proc.End))if (auto EC = IO.mapInteger(Proc.End)) return EC;;
413 error(IO.mapInteger(Proc.Next))if (auto EC = IO.mapInteger(Proc.Next)) return EC;;
414 error(IO.mapInteger(Proc.CodeSize))if (auto EC = IO.mapInteger(Proc.CodeSize)) return EC;;
415 error(IO.mapInteger(Proc.DbgStart))if (auto EC = IO.mapInteger(Proc.DbgStart)) return EC;;
416 error(IO.mapInteger(Proc.DbgEnd))if (auto EC = IO.mapInteger(Proc.DbgEnd)) return EC;;
417 error(IO.mapInteger(Proc.FunctionType))if (auto EC = IO.mapInteger(Proc.FunctionType)) return EC;;
418 error(IO.mapInteger(Proc.CodeOffset))if (auto EC = IO.mapInteger(Proc.CodeOffset)) return EC;;
419 error(IO.mapInteger(Proc.Segment))if (auto EC = IO.mapInteger(Proc.Segment)) return EC;;
420 error(IO.mapEnum(Proc.Flags))if (auto EC = IO.mapEnum(Proc.Flags)) return EC;;
421 error(IO.mapStringZ(Proc.Name))if (auto EC = IO.mapStringZ(Proc.Name)) return EC;;
422 return Error::success();
423}
424
425Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
426 ScopeEndSym &ScopeEnd) {
427 return Error::success();
428}
429
430Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, CallerSym &Caller) {
431 error(IO.mapVectorN<uint32_t>(if (auto EC = IO.mapVectorN<uint32_t>( Caller.Indices, [
](CodeViewRecordIO &IO, TypeIndex &N) { return IO.mapInteger
(N); })) return EC;
1
Within the expansion of the macro 'error':
→
a
Calling 'CodeViewRecordIO::mapVectorN'
432 Caller.Indices,if (auto EC = IO.mapVectorN<uint32_t>( Caller.Indices, [
](CodeViewRecordIO &IO, TypeIndex &N) { return IO.mapInteger
(N); })) return EC;
433 [](CodeViewRecordIO &IO, TypeIndex &N) { return IO.mapInteger(N); }))if (auto EC = IO.mapVectorN<uint32_t>( Caller.Indices, [
](CodeViewRecordIO &IO, TypeIndex &N) { return IO.mapInteger
(N); })) return EC;;
434 return Error::success();
435}
436
437Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
438 RegRelativeSym &RegRel) {
439
440 error(IO.mapInteger(RegRel.Offset))if (auto EC = IO.mapInteger(RegRel.Offset)) return EC;;
441 error(IO.mapInteger(RegRel.Type))if (auto EC = IO.mapInteger(RegRel.Type)) return EC;;
442 error(IO.mapEnum(RegRel.Register))if (auto EC = IO.mapEnum(RegRel.Register)) return EC;;
443 error(IO.mapStringZ(RegRel.Name))if (auto EC = IO.mapStringZ(RegRel.Name)) return EC;;
444
445 return Error::success();
446}
447
448Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR,
449 ThreadLocalDataSym &Data) {
450
451 error(IO.mapInteger(Data.Type))if (auto EC = IO.mapInteger(Data.Type)) return EC;;
452 error(IO.mapInteger(Data.DataOffset))if (auto EC = IO.mapInteger(Data.DataOffset)) return EC;;
453 error(IO.mapInteger(Data.Segment))if (auto EC = IO.mapInteger(Data.Segment)) return EC;;
454 error(IO.mapStringZ(Data.Name))if (auto EC = IO.mapStringZ(Data.Name)) return EC;;
455
456 return Error::success();
457}
458
459Error SymbolRecordMapping::visitKnownRecord(CVSymbol &CVR, UDTSym &UDT) {
460
461 error(IO.mapInteger(UDT.Type))if (auto EC = IO.mapInteger(UDT.Type)) return EC;;
462 error(IO.mapStringZ(UDT.Name))if (auto EC = IO.mapStringZ(UDT.Name)) return EC;;
463
464 return Error::success();
465}
←

/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/DebugInfo/CodeView/CodeViewRecordIO.h

→
1//===- CodeViewRecordIO.h ---------------------------------------*- C++ -*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef LLVM_DEBUGINFO_CODEVIEW_CODEVIEWRECORDIO_H
11#define LLVM_DEBUGINFO_CODEVIEW_CODEVIEWRECORDIO_H
12
13#include "llvm/ADT/APSInt.h"
14#include "llvm/ADT/None.h"
15#include "llvm/ADT/Optional.h"
16#include "llvm/ADT/SmallVector.h"
17#include "llvm/ADT/StringRef.h"
18#include "llvm/DebugInfo/CodeView/CodeViewError.h"
19#include "llvm/DebugInfo/CodeView/TypeRecord.h"
20#include "llvm/Support/BinaryStreamReader.h"
21#include "llvm/Support/BinaryStreamWriter.h"
22#include "llvm/Support/Error.h"
23#include <cassert>
24#include <cstdint>
25#include <type_traits>
26
27namespace llvm {
28namespace codeview {
29
30class CodeViewRecordIO {
31 uint32_t getCurrentOffset() const {
32 return (isWriting()) ? Writer->getOffset() : Reader->getOffset();
33 }
34
35public:
36 explicit CodeViewRecordIO(BinaryStreamReader &Reader) : Reader(&Reader) {}
37 explicit CodeViewRecordIO(BinaryStreamWriter &Writer) : Writer(&Writer) {}
38
39 Error beginRecord(Optional<uint32_t> MaxLength);
40 Error endRecord();
41
42 Error mapInteger(TypeIndex &TypeInd);
43
44 bool isReading() const { return Reader != nullptr; }
45 bool isWriting() const { return !isReading(); }
46
47 uint32_t maxFieldLength() const;
48
49 template <typename T> Error mapObject(T &Value) {
50 if (isWriting())
51 return Writer->writeObject(Value);
52
53 const T *ValuePtr;
54 if (auto EC = Reader->readObject(ValuePtr))
55 return EC;
56 Value = *ValuePtr;
57 return Error::success();
58 }
59
60 template <typename T> Error mapInteger(T &Value) {
61 if (isWriting())
62 return Writer->writeInteger(Value);
63
64 return Reader->readInteger(Value);
65 }
66
67 template <typename T> Error mapEnum(T &Value) {
68 if (sizeof(Value) > maxFieldLength())
69 return make_error<CodeViewError>(cv_error_code::insufficient_buffer);
70
71 using U = typename std::underlying_type<T>::type;
72 U X;
73 if (isWriting())
74 X = static_cast<U>(Value);
75
76 if (auto EC = mapInteger(X))
77 return EC;
78 if (isReading())
79 Value = static_cast<T>(X);
80 return Error::success();
81 }
82
83 Error mapEncodedInteger(int64_t &Value);
84 Error mapEncodedInteger(uint64_t &Value);
85 Error mapEncodedInteger(APSInt &Value);
86 Error mapStringZ(StringRef &Value);
87 Error mapGuid(GUID &Guid);
88
89 Error mapStringZVectorZ(std::vector<StringRef> &Value);
90
91 template <typename SizeType, typename T, typename ElementMapper>
92 Error mapVectorN(T &Items, const ElementMapper &Mapper) {
93 SizeType Size;
2
←
'Size' declared without an initial value
→
94 if (isWriting()) {
3
←
Taking false branch
→
95 Size = static_cast<SizeType>(Items.size());
96 if (auto EC = Writer->writeInteger(Size))
97 return EC;
98
99 for (auto &X : Items) {
100 if (auto EC = Mapper(*this, X))
101 return EC;
102 }
103 } else {
104 if (auto EC = Reader->readInteger(Size))
4
←
Calling 'BinaryStreamReader::readInteger'
→
50
←
Returning from 'BinaryStreamReader::readInteger'
→
51
←
Taking false branch
→
105 return EC;
106 for (SizeType I = 0; I < Size; ++I) {
52
←
The right operand of '<' is a garbage value
107 typename T::value_type Item;
108 if (auto EC = Mapper(*this, Item))
109 return EC;
110 Items.push_back(Item);
111 }
112 }
113
114 return Error::success();
115 }
116
117 template <typename T, typename ElementMapper>
118 Error mapVectorTail(T &Items, const ElementMapper &Mapper) {
119 if (isWriting()) {
120 for (auto &Item : Items) {
121 if (auto EC = Mapper(*this, Item))
122 return EC;
123 }
124 } else {
125 typename T::value_type Field;
126 // Stop when we run out of bytes or we hit record padding bytes.
127 while (!Reader->empty() && Reader->peek() < 0xf0 /* LF_PAD0 */) {
128 if (auto EC = Mapper(*this, Field))
129 return EC;
130 Items.push_back(Field);
131 }
132 }
133 return Error::success();
134 }
135
136 Error mapByteVectorTail(ArrayRef<uint8_t> &Bytes);
137 Error mapByteVectorTail(std::vector<uint8_t> &Bytes);
138
139 Error padToAlignment(uint32_t Align);
140 Error skipPadding();
141
142private:
143 Error writeEncodedSignedInteger(const int64_t &Value);
144 Error writeEncodedUnsignedInteger(const uint64_t &Value);
145
146 struct RecordLimit {
147 uint32_t BeginOffset;
148 Optional<uint32_t> MaxLength;
149
150 Optional<uint32_t> bytesRemaining(uint32_t CurrentOffset) const {
151 if (!MaxLength.hasValue())
152 return None;
153 assert(CurrentOffset >= BeginOffset)(static_cast <bool> (CurrentOffset >= BeginOffset) ?
void (0) : __assert_fail ("CurrentOffset >= BeginOffset",
"/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/DebugInfo/CodeView/CodeViewRecordIO.h"
, 153, __extension__ __PRETTY_FUNCTION__));
154
155 uint32_t BytesUsed = CurrentOffset - BeginOffset;
156 if (BytesUsed >= *MaxLength)
157 return 0;
158 return *MaxLength - BytesUsed;
159 }
160 };
161
162 SmallVector<RecordLimit, 2> Limits;
163
164 BinaryStreamReader *Reader = nullptr;
165 BinaryStreamWriter *Writer = nullptr;
166};
167
168} // end namespace codeview
169} // end namespace llvm
170
171#endif // LLVM_DEBUGINFO_CODEVIEW_CODEVIEWRECORDIO_H
←

/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/BinaryStreamReader.h

→
1//===- BinaryStreamReader.h - Reads objects from a binary stream *- C++ -*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef LLVM_SUPPORT_BINARYSTREAMREADER_H
11#define LLVM_SUPPORT_BINARYSTREAMREADER_H
12
13#include "llvm/ADT/ArrayRef.h"
14#include "llvm/ADT/STLExtras.h"
15#include "llvm/Support/BinaryStreamArray.h"
16#include "llvm/Support/BinaryStreamRef.h"
17#include "llvm/Support/ConvertUTF.h"
18#include "llvm/Support/Endian.h"
19#include "llvm/Support/Error.h"
20#include "llvm/Support/type_traits.h"
21
22#include <string>
23#include <type_traits>
24
25namespace llvm {
26
27/// \brief Provides read only access to a subclass of `BinaryStream`. Provides
28/// bounds checking and helpers for writing certain common data types such as
29/// null-terminated strings, integers in various flavors of endianness, etc.
30/// Can be subclassed to provide reading of custom datatypes, although no
31/// are overridable.
32class BinaryStreamReader {
33public:
34 BinaryStreamReader() = default;
35 explicit BinaryStreamReader(BinaryStreamRef Ref);
36 explicit BinaryStreamReader(BinaryStream &Stream);
37 explicit BinaryStreamReader(ArrayRef<uint8_t> Data,
38 llvm::support::endianness Endian);
39 explicit BinaryStreamReader(StringRef Data, llvm::support::endianness Endian);
40
41 BinaryStreamReader(const BinaryStreamReader &Other)
42 : Stream(Other.Stream), Offset(Other.Offset) {}
43
44 BinaryStreamReader &operator=(const BinaryStreamReader &Other) {
45 Stream = Other.Stream;
46 Offset = Other.Offset;
47 return *this;
48 }
49
50 virtual ~BinaryStreamReader() {}
51
52 /// Read as much as possible from the underlying string at the current offset
53 /// without invoking a copy, and set \p Buffer to the resulting data slice.
54 /// Updates the stream's offset to point after the newly read data.
55 ///
56 /// \returns a success error code if the data was successfully read, otherwise
57 /// returns an appropriate error code.
58 Error readLongestContiguousChunk(ArrayRef<uint8_t> &Buffer);
59
60 /// Read \p Size bytes from the underlying stream at the current offset and
61 /// and set \p Buffer to the resulting data slice. Whether a copy occurs
62 /// depends on the implementation of the underlying stream. Updates the
63 /// stream's offset to point after the newly read data.
64 ///
65 /// \returns a success error code if the data was successfully read, otherwise
66 /// returns an appropriate error code.
67 Error readBytes(ArrayRef<uint8_t> &Buffer, uint32_t Size);
68
69 /// Read an integer of the specified endianness into \p Dest and update the
70 /// stream's offset. The data is always copied from the stream's underlying
71 /// buffer into \p Dest. Updates the stream's offset to point after the newly
72 /// read data.
73 ///
74 /// \returns a success error code if the data was successfully read, otherwise
75 /// returns an appropriate error code.
76 template <typename T> Error readInteger(T &Dest) {
77 static_assert(std::is_integral<T>::value,
78 "Cannot call readInteger with non-integral value!");
79
80 ArrayRef<uint8_t> Bytes;
81 if (auto EC = readBytes(Bytes, sizeof(T)))
5
←
Calling move constructor for 'Error'
→
29
←
Returning from move constructor for 'Error'
→
30
←
Calling 'Error::operator bool'
→
39
←
Returning from 'Error::operator bool'
→
40
←
Taking true branch
→
82 return EC;
41
←
Calling '~Error'
→
48
←
Returning from '~Error'
→
83
84 Dest = llvm::support::endian::read<T, llvm::support::unaligned>(
85 Bytes.data(), Stream.getEndian());
86 return Error::success();
87 }
49
←
Returning without writing to 'Dest'
→
88
89 /// Similar to readInteger.
90 template <typename T> Error readEnum(T &Dest) {
91 static_assert(std::is_enum<T>::value,
92 "Cannot call readEnum with non-enum value!");
93 typename std::underlying_type<T>::type N;
94 if (auto EC = readInteger(N))
95 return EC;
96 Dest = static_cast<T>(N);
97 return Error::success();
98 }
99
100 /// Read a null terminated string from \p Dest. Whether a copy occurs depends
101 /// on the implementation of the underlying stream. Updates the stream's
102 /// offset to point after the newly read data.
103 ///
104 /// \returns a success error code if the data was successfully read, otherwise
105 /// returns an appropriate error code.
106 Error readCString(StringRef &Dest);
107
108 /// Similar to readCString, however read a null-terminated UTF16 string
109 /// instead.
110 ///
111 /// \returns a success error code if the data was successfully read, otherwise
112 /// returns an appropriate error code.
113 Error readWideString(ArrayRef<UTF16> &Dest);
114
115 /// Read a \p Length byte string into \p Dest. Whether a copy occurs depends
116 /// on the implementation of the underlying stream. Updates the stream's
117 /// offset to point after the newly read data.
118 ///
119 /// \returns a success error code if the data was successfully read, otherwise
120 /// returns an appropriate error code.
121 Error readFixedString(StringRef &Dest, uint32_t Length);
122
123 /// Read the entire remainder of the underlying stream into \p Ref. This is
124 /// equivalent to calling getUnderlyingStream().slice(Offset). Updates the
125 /// stream's offset to point to the end of the stream. Never causes a copy.
126 ///
127 /// \returns a success error code if the data was successfully read, otherwise
128 /// returns an appropriate error code.
129 Error readStreamRef(BinaryStreamRef &Ref);
130
131 /// Read \p Length bytes from the underlying stream into \p Ref. This is
132 /// equivalent to calling getUnderlyingStream().slice(Offset, Length).
133 /// Updates the stream's offset to point after the newly read object. Never
134 /// causes a copy.
135 ///
136 /// \returns a success error code if the data was successfully read, otherwise
137 /// returns an appropriate error code.
138 Error readStreamRef(BinaryStreamRef &Ref, uint32_t Length);
139
140 /// Read \p Length bytes from the underlying stream into \p Stream. This is
141 /// equivalent to calling getUnderlyingStream().slice(Offset, Length).
142 /// Updates the stream's offset to point after the newly read object. Never
143 /// causes a copy.
144 ///
145 /// \returns a success error code if the data was successfully read, otherwise
146 /// returns an appropriate error code.
147 Error readSubstream(BinarySubstreamRef &Stream, uint32_t Size);
148
149 /// Get a pointer to an object of type T from the underlying stream, as if by
150 /// memcpy, and store the result into \p Dest. It is up to the caller to
151 /// ensure that objects of type T can be safely treated in this manner.
152 /// Updates the stream's offset to point after the newly read object. Whether
153 /// a copy occurs depends upon the implementation of the underlying
154 /// stream.
155 ///
156 /// \returns a success error code if the data was successfully read, otherwise
157 /// returns an appropriate error code.
158 template <typename T> Error readObject(const T *&Dest) {
159 ArrayRef<uint8_t> Buffer;
160 if (auto EC = readBytes(Buffer, sizeof(T)))
161 return EC;
162 Dest = reinterpret_cast<const T *>(Buffer.data());
163 return Error::success();
164 }
165
166 /// Get a reference to a \p NumElements element array of objects of type T
167 /// from the underlying stream as if by memcpy, and store the resulting array
168 /// slice into \p array. It is up to the caller to ensure that objects of
169 /// type T can be safely treated in this manner. Updates the stream's offset
170 /// to point after the newly read object. Whether a copy occurs depends upon
171 /// the implementation of the underlying stream.
172 ///
173 /// \returns a success error code if the data was successfully read, otherwise
174 /// returns an appropriate error code.
175 template <typename T>
176 Error readArray(ArrayRef<T> &Array, uint32_t NumElements) {
177 ArrayRef<uint8_t> Bytes;
178 if (NumElements == 0) {
179 Array = ArrayRef<T>();
180 return Error::success();
181 }
182
183 if (NumElements > UINT32_MAX(4294967295U) / sizeof(T))
184 return make_error<BinaryStreamError>(
185 stream_error_code::invalid_array_size);
186
187 if (auto EC = readBytes(Bytes, NumElements * sizeof(T)))
188 return EC;
189
190 assert(alignmentAdjustment(Bytes.data(), alignof(T)) == 0 &&(static_cast <bool> (alignmentAdjustment(Bytes.data(), alignof
(T)) == 0 && "Reading at invalid alignment!") ? void (
0) : __assert_fail ("alignmentAdjustment(Bytes.data(), alignof(T)) == 0 && \"Reading at invalid alignment!\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/BinaryStreamReader.h"
, 191, __extension__ __PRETTY_FUNCTION__))
191 "Reading at invalid alignment!")(static_cast <bool> (alignmentAdjustment(Bytes.data(), alignof
(T)) == 0 && "Reading at invalid alignment!") ? void (
0) : __assert_fail ("alignmentAdjustment(Bytes.data(), alignof(T)) == 0 && \"Reading at invalid alignment!\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/BinaryStreamReader.h"
, 191, __extension__ __PRETTY_FUNCTION__));
192
193 Array = ArrayRef<T>(reinterpret_cast<const T *>(Bytes.data()), NumElements);
194 return Error::success();
195 }
196
197 /// Read a VarStreamArray of size \p Size bytes and store the result into
198 /// \p Array. Updates the stream's offset to point after the newly read
199 /// array. Never causes a copy (although iterating the elements of the
200 /// VarStreamArray may, depending upon the implementation of the underlying
201 /// stream).
202 ///
203 /// \returns a success error code if the data was successfully read, otherwise
204 /// returns an appropriate error code.
205 template <typename T, typename U>
206 Error readArray(VarStreamArray<T, U> &Array, uint32_t Size) {
207 BinaryStreamRef S;
208 if (auto EC = readStreamRef(S, Size))
209 return EC;
210 Array.setUnderlyingStream(S);
211 return Error::success();
212 }
213
214 /// Read a FixedStreamArray of \p NumItems elements and store the result into
215 /// \p Array. Updates the stream's offset to point after the newly read
216 /// array. Never causes a copy (although iterating the elements of the
217 /// FixedStreamArray may, depending upon the implementation of the underlying
218 /// stream).
219 ///
220 /// \returns a success error code if the data was successfully read, otherwise
221 /// returns an appropriate error code.
222 template <typename T>
223 Error readArray(FixedStreamArray<T> &Array, uint32_t NumItems) {
224 if (NumItems == 0) {
225 Array = FixedStreamArray<T>();
226 return Error::success();
227 }
228
229 if (NumItems > UINT32_MAX(4294967295U) / sizeof(T))
230 return make_error<BinaryStreamError>(
231 stream_error_code::invalid_array_size);
232
233 BinaryStreamRef View;
234 if (auto EC = readStreamRef(View, NumItems * sizeof(T)))
235 return EC;
236
237 Array = FixedStreamArray<T>(View);
238 return Error::success();
239 }
240
241 bool empty() const { return bytesRemaining() == 0; }
242 void setOffset(uint32_t Off) { Offset = Off; }
243 uint32_t getOffset() const { return Offset; }
244 uint32_t getLength() const { return Stream.getLength(); }
245 uint32_t bytesRemaining() const { return getLength() - getOffset(); }
246
247 /// Advance the stream's offset by \p Amount bytes.
248 ///
249 /// \returns a success error code if at least \p Amount bytes remain in the
250 /// stream, otherwise returns an appropriate error code.
251 Error skip(uint32_t Amount);
252
253 /// Examine the next byte of the underlying stream without advancing the
254 /// stream's offset. If the stream is empty the behavior is undefined.
255 ///
256 /// \returns the next byte in the stream.
257 uint8_t peek() const;
258
259 Error padToAlignment(uint32_t Align);
260
261 std::pair<BinaryStreamReader, BinaryStreamReader>
262 split(uint32_t Offset) const;
263
264private:
265 BinaryStreamRef Stream;
266 uint32_t Offset = 0;
267};
268} // namespace llvm
269
270#endif // LLVM_SUPPORT_BINARYSTREAMREADER_H
←

/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h

1//===- llvm/Support/Error.h - Recoverable error handling --------*- C++ -*-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This file defines an API used to report recoverable errors.
11//
12//===----------------------------------------------------------------------===//
13
14#ifndef LLVM_SUPPORT_ERROR_H
15#define LLVM_SUPPORT_ERROR_H
16
17#include "llvm/ADT/SmallVector.h"
18#include "llvm/ADT/STLExtras.h"
19#include "llvm/ADT/StringExtras.h"
20#include "llvm/ADT/Twine.h"
21#include "llvm/Config/abi-breaking.h"
22#include "llvm/Support/AlignOf.h"
23#include "llvm/Support/Compiler.h"
24#include "llvm/Support/Debug.h"
25#include "llvm/Support/ErrorHandling.h"
26#include "llvm/Support/ErrorOr.h"
27#include "llvm/Support/raw_ostream.h"
28#include <algorithm>
29#include <cassert>
30#include <cstdint>
31#include <cstdlib>
32#include <functional>
33#include <memory>
34#include <new>
35#include <string>
36#include <system_error>
37#include <type_traits>
38#include <utility>
39#include <vector>
40
41namespace llvm {
42
43class ErrorSuccess;
44
45/// Base class for error info classes. Do not extend this directly: Extend
46/// the ErrorInfo template subclass instead.
47class ErrorInfoBase {
48public:
49 virtual ~ErrorInfoBase() = default;
50
51 /// Print an error message to an output stream.
52 virtual void log(raw_ostream &OS) const = 0;
53
54 /// Return the error message as a string.
55 virtual std::string message() const {
56 std::string Msg;
57 raw_string_ostream OS(Msg);
58 log(OS);
59 return OS.str();
60 }
61
62 /// Convert this error to a std::error_code.
63 ///
64 /// This is a temporary crutch to enable interaction with code still
65 /// using std::error_code. It will be removed in the future.
66 virtual std::error_code convertToErrorCode() const = 0;
67
68 // Returns the class ID for this type.
69 static const void *classID() { return &ID; }
70
71 // Returns the class ID for the dynamic type of this ErrorInfoBase instance.
72 virtual const void *dynamicClassID() const = 0;
73
74 // Check whether this instance is a subclass of the class identified by
75 // ClassID.
76 virtual bool isA(const void *const ClassID) const {
77 return ClassID == classID();
78 }
79
80 // Check whether this instance is a subclass of ErrorInfoT.
81 template <typename ErrorInfoT> bool isA() const {
82 return isA(ErrorInfoT::classID());
83 }
84
85private:
86 virtual void anchor();
87
88 static char ID;
89};
90
91/// Lightweight error class with error context and mandatory checking.
92///
93/// Instances of this class wrap a ErrorInfoBase pointer. Failure states
94/// are represented by setting the pointer to a ErrorInfoBase subclass
95/// instance containing information describing the failure. Success is
96/// represented by a null pointer value.
97///
98/// Instances of Error also contains a 'Checked' flag, which must be set
99/// before the destructor is called, otherwise the destructor will trigger a
100/// runtime error. This enforces at runtime the requirement that all Error
101/// instances be checked or returned to the caller.
102///
103/// There are two ways to set the checked flag, depending on what state the
104/// Error instance is in. For Error instances indicating success, it
105/// is sufficient to invoke the boolean conversion operator. E.g.:
106///
107/// @code{.cpp}
108/// Error foo(<...>);
109///
110/// if (auto E = foo(<...>))
111/// return E; // <- Return E if it is in the error state.
112/// // We have verified that E was in the success state. It can now be safely
113/// // destroyed.
114/// @endcode
115///
116/// A success value *can not* be dropped. For example, just calling 'foo(<...>)'
117/// without testing the return value will raise a runtime error, even if foo
118/// returns success.
119///
120/// For Error instances representing failure, you must use either the
121/// handleErrors or handleAllErrors function with a typed handler. E.g.:
122///
123/// @code{.cpp}
124/// class MyErrorInfo : public ErrorInfo<MyErrorInfo> {
125/// // Custom error info.
126/// };
127///
128/// Error foo(<...>) { return make_error<MyErrorInfo>(...); }
129///
130/// auto E = foo(<...>); // <- foo returns failure with MyErrorInfo.
131/// auto NewE =
132/// handleErrors(E,
133/// [](const MyErrorInfo &M) {
134/// // Deal with the error.
135/// },
136/// [](std::unique_ptr<OtherError> M) -> Error {
137/// if (canHandle(*M)) {
138/// // handle error.
139/// return Error::success();
140/// }
141/// // Couldn't handle this error instance. Pass it up the stack.
142/// return Error(std::move(M));
143/// );
144/// // Note - we must check or return NewE in case any of the handlers
145/// // returned a new error.
146/// @endcode
147///
148/// The handleAllErrors function is identical to handleErrors, except
149/// that it has a void return type, and requires all errors to be handled and
150/// no new errors be returned. It prevents errors (assuming they can all be
151/// handled) from having to be bubbled all the way to the top-level.
152///
153/// *All* Error instances must be checked before destruction, even if
154/// they're moved-assigned or constructed from Success values that have already
155/// been checked. This enforces checking through all levels of the call stack.
156class LLVM_NODISCARD[[clang::warn_unused_result]] Error {
157 // ErrorList needs to be able to yank ErrorInfoBase pointers out of this
158 // class to add to the error list.
159 friend class ErrorList;
160
161 // handleErrors needs to be able to set the Checked flag.
162 template <typename... HandlerTs>
163 friend Error handleErrors(Error E, HandlerTs &&... Handlers);
164
165 // Expected<T> needs to be able to steal the payload when constructed from an
166 // error.
167 template <typename T> friend class Expected;
168
169protected:
170 /// Create a success value. Prefer using 'Error::success()' for readability
171 Error() {
172 setPtr(nullptr);
173 setChecked(false);
174 }
175
176public:
177 /// Create a success value.
178 static ErrorSuccess success();
179
180 // Errors are not copy-constructable.
181 Error(const Error &Other) = delete;
182
183 /// Move-construct an error value. The newly constructed error is considered
184 /// unchecked, even if the source error had been checked. The original error
185 /// becomes a checked Success value, regardless of its original state.
186 Error(Error &&Other) {
187 setChecked(true);
6
←
Calling 'Error::setChecked'
→
8
←
Returning from 'Error::setChecked'
→
188 *this = std::move(Other);
9
←
Calling 'move'
→
10
←
Returning from 'move'
→
11
←
Calling move assignment operator for 'Error'
→
28
←
Returning from move assignment operator for 'Error'
→
189 }
190
191 /// Create an error value. Prefer using the 'make_error' function, but
192 /// this constructor can be useful when "re-throwing" errors from handlers.
193 Error(std::unique_ptr<ErrorInfoBase> Payload) {
194 setPtr(Payload.release());
195 setChecked(false);
196 }
197
198 // Errors are not copy-assignable.
199 Error &operator=(const Error &Other) = delete;
200
201 /// Move-assign an error value. The current error must represent success, you
202 /// you cannot overwrite an unhandled error. The current error is then
203 /// considered unchecked. The source error becomes a checked success value,
204 /// regardless of its original state.
205 Error &operator=(Error &&Other) {
206 // Don't allow overwriting of unchecked values.
207 assertIsChecked();
12
←
Calling 'Error::assertIsChecked'
→
15
←
Returning from 'Error::assertIsChecked'
→
208 setPtr(Other.getPtr());
16
←
Calling 'Error::getPtr'
→
17
←
Returning from 'Error::getPtr'
→
18
←
Calling 'Error::setPtr'
→
19
←
Returning from 'Error::setPtr'
→
209
210 // This Error is unchecked, even if the source error was checked.
211 setChecked(false);
20
←
Calling 'Error::setChecked'
→
22
←
Returning from 'Error::setChecked'
→
212
213 // Null out Other's payload and set its checked bit.
214 Other.setPtr(nullptr);
23
←
Calling 'Error::setPtr'
→
24
←
Returning from 'Error::setPtr'
→
215 Other.setChecked(true);
25
←
Calling 'Error::setChecked'
→
27
←
Returning from 'Error::setChecked'
→
216
217 return *this;
218 }
219
220 /// Destroy a Error. Fails with a call to abort() if the error is
221 /// unchecked.
222 ~Error() {
223 assertIsChecked();
42
←
Calling 'Error::assertIsChecked'
→
45
←
Returning from 'Error::assertIsChecked'
→
224 delete getPtr();
46
←
Calling 'Error::getPtr'
→
47
←
Returning from 'Error::getPtr'
→
225 }
226
227 /// Bool conversion. Returns true if this Error is in a failure state,
228 /// and false if it is in an accept state. If the error is in a Success state
229 /// it will be considered checked.
230 explicit operator bool() {
231 setChecked(getPtr() == nullptr);
31
←
Calling 'Error::getPtr'
→
32
←
Returning from 'Error::getPtr'
→
33
←
Calling 'Error::setChecked'
→
36
←
Returning from 'Error::setChecked'
→
232 return getPtr() != nullptr;
37
←
Calling 'Error::getPtr'
→
38
←
Returning from 'Error::getPtr'
→
233 }
234
235 /// Check whether one error is a subclass of another.
236 template <typename ErrT> bool isA() const {
237 return getPtr() && getPtr()->isA(ErrT::classID());
238 }
239
240 /// Returns the dynamic class id of this error, or null if this is a success
241 /// value.
242 const void* dynamicClassID() const {
243 if (!getPtr())
244 return nullptr;
245 return getPtr()->dynamicClassID();
246 }
247
248private:
249#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
250 // assertIsChecked() happens very frequently, but under normal circumstances
251 // is supposed to be a no-op. So we want it to be inlined, but having a bunch
252 // of debug prints can cause the function to be too large for inlining. So
253 // it's important that we define this function out of line so that it can't be
254 // inlined.
255 LLVM_ATTRIBUTE_NORETURN__attribute__((noreturn))
256 void fatalUncheckedError() const;
257#endif
258
259 void assertIsChecked() {
260#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
261 if (LLVM_UNLIKELY(!getChecked() || getPtr())__builtin_expect((bool)(!getChecked() || getPtr()), false))
13
←
Within the expansion of the macro 'LLVM_UNLIKELY':
→
a
Calling 'Error::getChecked'
b
Returning from 'Error::getChecked'
c
Calling 'Error::getPtr'
d
Returning from 'Error::getPtr'
14
←
Taking false branch
→
43
←
Within the expansion of the macro 'LLVM_UNLIKELY':
→
a
Calling 'Error::getChecked'
b
Returning from 'Error::getChecked'
44
←
Taking false branch
→
262 fatalUncheckedError();
263#endif
264 }
265
266 ErrorInfoBase *getPtr() const {
267 return reinterpret_cast<ErrorInfoBase*>(
268 reinterpret_cast<uintptr_t>(Payload) &
269 ~static_cast<uintptr_t>(0x1));
270 }
271
272 void setPtr(ErrorInfoBase *EI) {
273#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
274 Payload = reinterpret_cast<ErrorInfoBase*>(
275 (reinterpret_cast<uintptr_t>(EI) &
276 ~static_cast<uintptr_t>(0x1)) |
277 (reinterpret_cast<uintptr_t>(Payload) & 0x1));
278#else
279 Payload = EI;
280#endif
281 }
282
283 bool getChecked() const {
284#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
285 return (reinterpret_cast<uintptr_t>(Payload) & 0x1) == 0;
286#else
287 return true;
288#endif
289 }
290
291 void setChecked(bool V) {
292 Payload = reinterpret_cast<ErrorInfoBase*>(
293 (reinterpret_cast<uintptr_t>(Payload) &
294 ~static_cast<uintptr_t>(0x1)) |
295 (V ? 0 : 1));
7
←
'?' condition is true
→
21
←
'?' condition is false
→
26
←
'?' condition is true
→
34
←
Assuming 'V' is 0
→
35
←
'?' condition is false
→
296 }
297
298 std::unique_ptr<ErrorInfoBase> takePayload() {
299 std::unique_ptr<ErrorInfoBase> Tmp(getPtr());
300 setPtr(nullptr);
301 setChecked(true);
302 return Tmp;
303 }
304
305 ErrorInfoBase *Payload = nullptr;
306};
307
308/// Subclass of Error for the sole purpose of identifying the success path in
309/// the type system. This allows to catch invalid conversion to Expected<T> at
310/// compile time.
311class ErrorSuccess : public Error {};
312
313inline ErrorSuccess Error::success() { return ErrorSuccess(); }
314
315/// Make a Error instance representing failure using the given error info
316/// type.
317template <typename ErrT, typename... ArgTs> Error make_error(ArgTs &&... Args) {
318 return Error(llvm::make_unique<ErrT>(std::forward<ArgTs>(Args)...));
319}
320
321/// Base class for user error types. Users should declare their error types
322/// like:
323///
324/// class MyError : public ErrorInfo<MyError> {
325/// ....
326/// };
327///
328/// This class provides an implementation of the ErrorInfoBase::kind
329/// method, which is used by the Error RTTI system.
330template <typename ThisErrT, typename ParentErrT = ErrorInfoBase>
331class ErrorInfo : public ParentErrT {
332public:
333 static const void *classID() { return &ThisErrT::ID; }
334
335 const void *dynamicClassID() const override { return &ThisErrT::ID; }
336
337 bool isA(const void *const ClassID) const override {
338 return ClassID == classID() || ParentErrT::isA(ClassID);
339 }
340};
341
342/// Special ErrorInfo subclass representing a list of ErrorInfos.
343/// Instances of this class are constructed by joinError.
344class ErrorList final : public ErrorInfo<ErrorList> {
345 // handleErrors needs to be able to iterate the payload list of an
346 // ErrorList.
347 template <typename... HandlerTs>
348 friend Error handleErrors(Error E, HandlerTs &&... Handlers);
349
350 // joinErrors is implemented in terms of join.
351 friend Error joinErrors(Error, Error);
352
353public:
354 void log(raw_ostream &OS) const override {
355 OS << "Multiple errors:\n";
356 for (auto &ErrPayload : Payloads) {
357 ErrPayload->log(OS);
358 OS << "\n";
359 }
360 }
361
362 std::error_code convertToErrorCode() const override;
363
364 // Used by ErrorInfo::classID.
365 static char ID;
366
367private:
368 ErrorList(std::unique_ptr<ErrorInfoBase> Payload1,
369 std::unique_ptr<ErrorInfoBase> Payload2) {
370 assert(!Payload1->isA<ErrorList>() && !Payload2->isA<ErrorList>() &&(static_cast <bool> (!Payload1->isA<ErrorList>
() && !Payload2->isA<ErrorList>() &&
"ErrorList constructor payloads should be singleton errors")
? void (0) : __assert_fail ("!Payload1->isA<ErrorList>() && !Payload2->isA<ErrorList>() && \"ErrorList constructor payloads should be singleton errors\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 371, __extension__ __PRETTY_FUNCTION__))
371 "ErrorList constructor payloads should be singleton errors")(static_cast <bool> (!Payload1->isA<ErrorList>
() && !Payload2->isA<ErrorList>() &&
"ErrorList constructor payloads should be singleton errors")
? void (0) : __assert_fail ("!Payload1->isA<ErrorList>() && !Payload2->isA<ErrorList>() && \"ErrorList constructor payloads should be singleton errors\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 371, __extension__ __PRETTY_FUNCTION__));
372 Payloads.push_back(std::move(Payload1));
373 Payloads.push_back(std::move(Payload2));
374 }
375
376 static Error join(Error E1, Error E2) {
377 if (!E1)
378 return E2;
379 if (!E2)
380 return E1;
381 if (E1.isA<ErrorList>()) {
382 auto &E1List = static_cast<ErrorList &>(*E1.getPtr());
383 if (E2.isA<ErrorList>()) {
384 auto E2Payload = E2.takePayload();
385 auto &E2List = static_cast<ErrorList &>(*E2Payload);
386 for (auto &Payload : E2List.Payloads)
387 E1List.Payloads.push_back(std::move(Payload));
388 } else
389 E1List.Payloads.push_back(E2.takePayload());
390
391 return E1;
392 }
393 if (E2.isA<ErrorList>()) {
394 auto &E2List = static_cast<ErrorList &>(*E2.getPtr());
395 E2List.Payloads.insert(E2List.Payloads.begin(), E1.takePayload());
396 return E2;
397 }
398 return Error(std::unique_ptr<ErrorList>(
399 new ErrorList(E1.takePayload(), E2.takePayload())));
400 }
401
402 std::vector<std::unique_ptr<ErrorInfoBase>> Payloads;
403};
404
405/// Concatenate errors. The resulting Error is unchecked, and contains the
406/// ErrorInfo(s), if any, contained in E1, followed by the
407/// ErrorInfo(s), if any, contained in E2.
408inline Error joinErrors(Error E1, Error E2) {
409 return ErrorList::join(std::move(E1), std::move(E2));
410}
411
412/// Tagged union holding either a T or a Error.
413///
414/// This class parallels ErrorOr, but replaces error_code with Error. Since
415/// Error cannot be copied, this class replaces getError() with
416/// takeError(). It also adds an bool errorIsA<ErrT>() method for testing the
417/// error class type.
418template <class T> class LLVM_NODISCARD[[clang::warn_unused_result]] Expected {
419 template <class T1> friend class ExpectedAsOutParameter;
420 template <class OtherT> friend class Expected;
421
422 static const bool isRef = std::is_reference<T>::value;
423
424 using wrap = ReferenceStorage<typename std::remove_reference<T>::type>;
425
426 using error_type = std::unique_ptr<ErrorInfoBase>;
427
428public:
429 using storage_type = typename std::conditional<isRef, wrap, T>::type;
430 using value_type = T;
431
432private:
433 using reference = typename std::remove_reference<T>::type &;
434 using const_reference = const typename std::remove_reference<T>::type &;
435 using pointer = typename std::remove_reference<T>::type *;
436 using const_pointer = const typename std::remove_reference<T>::type *;
437
438public:
439 /// Create an Expected<T> error value from the given Error.
440 Expected(Error Err)
441 : HasError(true)
442#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
443 // Expected is unchecked upon construction in Debug builds.
444 , Unchecked(true)
445#endif
446 {
447 assert(Err && "Cannot create Expected<T> from Error success value.")(static_cast <bool> (Err && "Cannot create Expected<T> from Error success value."
) ? void (0) : __assert_fail ("Err && \"Cannot create Expected<T> from Error success value.\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 447, __extension__ __PRETTY_FUNCTION__));
448 new (getErrorStorage()) error_type(Err.takePayload());
449 }
450
451 /// Forbid to convert from Error::success() implicitly, this avoids having
452 /// Expected<T> foo() { return Error::success(); } which compiles otherwise
453 /// but triggers the assertion above.
454 Expected(ErrorSuccess) = delete;
455
456 /// Create an Expected<T> success value from the given OtherT value, which
457 /// must be convertible to T.
458 template <typename OtherT>
459 Expected(OtherT &&Val,
460 typename std::enable_if<std::is_convertible<OtherT, T>::value>::type
461 * = nullptr)
462 : HasError(false)
463#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
464 // Expected is unchecked upon construction in Debug builds.
465 , Unchecked(true)
466#endif
467 {
468 new (getStorage()) storage_type(std::forward<OtherT>(Val));
469 }
470
471 /// Move construct an Expected<T> value.
472 Expected(Expected &&Other) { moveConstruct(std::move(Other)); }
473
474 /// Move construct an Expected<T> value from an Expected<OtherT>, where OtherT
475 /// must be convertible to T.
476 template <class OtherT>
477 Expected(Expected<OtherT> &&Other,
478 typename std::enable_if<std::is_convertible<OtherT, T>::value>::type
479 * = nullptr) {
480 moveConstruct(std::move(Other));
481 }
482
483 /// Move construct an Expected<T> value from an Expected<OtherT>, where OtherT
484 /// isn't convertible to T.
485 template <class OtherT>
486 explicit Expected(
487 Expected<OtherT> &&Other,
488 typename std::enable_if<!std::is_convertible<OtherT, T>::value>::type * =
489 nullptr) {
490 moveConstruct(std::move(Other));
491 }
492
493 /// Move-assign from another Expected<T>.
494 Expected &operator=(Expected &&Other) {
495 moveAssign(std::move(Other));
496 return *this;
497 }
498
499 /// Destroy an Expected<T>.
500 ~Expected() {
501 assertIsChecked();
502 if (!HasError)
503 getStorage()->~storage_type();
504 else
505 getErrorStorage()->~error_type();
506 }
507
508 /// \brief Return false if there is an error.
509 explicit operator bool() {
510#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
511 Unchecked = HasError;
512#endif
513 return !HasError;
514 }
515
516 /// \brief Returns a reference to the stored T value.
517 reference get() {
518 assertIsChecked();
519 return *getStorage();
520 }
521
522 /// \brief Returns a const reference to the stored T value.
523 const_reference get() const {
524 assertIsChecked();
525 return const_cast<Expected<T> *>(this)->get();
526 }
527
528 /// \brief Check that this Expected<T> is an error of type ErrT.
529 template <typename ErrT> bool errorIsA() const {
530 return HasError && (*getErrorStorage())->template isA<ErrT>();
531 }
532
533 /// \brief Take ownership of the stored error.
534 /// After calling this the Expected<T> is in an indeterminate state that can
535 /// only be safely destructed. No further calls (beside the destructor) should
536 /// be made on the Expected<T> vaule.
537 Error takeError() {
538#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
539 Unchecked = false;
540#endif
541 return HasError ? Error(std::move(*getErrorStorage())) : Error::success();
542 }
543
544 /// \brief Returns a pointer to the stored T value.
545 pointer operator->() {
546 assertIsChecked();
547 return toPointer(getStorage());
548 }
549
550 /// \brief Returns a const pointer to the stored T value.
551 const_pointer operator->() const {
552 assertIsChecked();
553 return toPointer(getStorage());
554 }
555
556 /// \brief Returns a reference to the stored T value.
557 reference operator*() {
558 assertIsChecked();
559 return *getStorage();
560 }
561
562 /// \brief Returns a const reference to the stored T value.
563 const_reference operator*() const {
564 assertIsChecked();
565 return *getStorage();
566 }
567
568private:
569 template <class T1>
570 static bool compareThisIfSameType(const T1 &a, const T1 &b) {
571 return &a == &b;
572 }
573
574 template <class T1, class T2>
575 static bool compareThisIfSameType(const T1 &a, const T2 &b) {
576 return false;
577 }
578
579 template <class OtherT> void moveConstruct(Expected<OtherT> &&Other) {
580 HasError = Other.HasError;
581#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
582 Unchecked = true;
583 Other.Unchecked = false;
584#endif
585
586 if (!HasError)
587 new (getStorage()) storage_type(std::move(*Other.getStorage()));
588 else
589 new (getErrorStorage()) error_type(std::move(*Other.getErrorStorage()));
590 }
591
592 template <class OtherT> void moveAssign(Expected<OtherT> &&Other) {
593 assertIsChecked();
594
595 if (compareThisIfSameType(*this, Other))
596 return;
597
598 this->~Expected();
599 new (this) Expected(std::move(Other));
600 }
601
602 pointer toPointer(pointer Val) { return Val; }
603
604 const_pointer toPointer(const_pointer Val) const { return Val; }
605
606 pointer toPointer(wrap *Val) { return &Val->get(); }
607
608 const_pointer toPointer(const wrap *Val) const { return &Val->get(); }
609
610 storage_type *getStorage() {
611 assert(!HasError && "Cannot get value when an error exists!")(static_cast <bool> (!HasError && "Cannot get value when an error exists!"
) ? void (0) : __assert_fail ("!HasError && \"Cannot get value when an error exists!\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 611, __extension__ __PRETTY_FUNCTION__));
612 return reinterpret_cast<storage_type *>(TStorage.buffer);
613 }
614
615 const storage_type *getStorage() const {
616 assert(!HasError && "Cannot get value when an error exists!")(static_cast <bool> (!HasError && "Cannot get value when an error exists!"
) ? void (0) : __assert_fail ("!HasError && \"Cannot get value when an error exists!\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 616, __extension__ __PRETTY_FUNCTION__));
617 return reinterpret_cast<const storage_type *>(TStorage.buffer);
618 }
619
620 error_type *getErrorStorage() {
621 assert(HasError && "Cannot get error when a value exists!")(static_cast <bool> (HasError && "Cannot get error when a value exists!"
) ? void (0) : __assert_fail ("HasError && \"Cannot get error when a value exists!\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 621, __extension__ __PRETTY_FUNCTION__));
622 return reinterpret_cast<error_type *>(ErrorStorage.buffer);
623 }
624
625 const error_type *getErrorStorage() const {
626 assert(HasError && "Cannot get error when a value exists!")(static_cast <bool> (HasError && "Cannot get error when a value exists!"
) ? void (0) : __assert_fail ("HasError && \"Cannot get error when a value exists!\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 626, __extension__ __PRETTY_FUNCTION__));
627 return reinterpret_cast<const error_type *>(ErrorStorage.buffer);
628 }
629
630 // Used by ExpectedAsOutParameter to reset the checked flag.
631 void setUnchecked() {
632#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
633 Unchecked = true;
634#endif
635 }
636
637#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
638 LLVM_ATTRIBUTE_NORETURN__attribute__((noreturn))
639 LLVM_ATTRIBUTE_NOINLINE__attribute__((noinline))
640 void fatalUncheckedExpected() const {
641 dbgs() << "Expected<T> must be checked before access or destruction.\n";
642 if (HasError) {
643 dbgs() << "Unchecked Expected<T> contained error:\n";
644 (*getErrorStorage())->log(dbgs());
645 } else
646 dbgs() << "Expected<T> value was in success state. (Note: Expected<T> "
647 "values in success mode must still be checked prior to being "
648 "destroyed).\n";
649 abort();
650 }
651#endif
652
653 void assertIsChecked() {
654#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
655 if (LLVM_UNLIKELY(Unchecked)__builtin_expect((bool)(Unchecked), false))
656 fatalUncheckedExpected();
657#endif
658 }
659
660 union {
661 AlignedCharArrayUnion<storage_type> TStorage;
662 AlignedCharArrayUnion<error_type> ErrorStorage;
663 };
664 bool HasError : 1;
665#if LLVM_ENABLE_ABI_BREAKING_CHECKS1
666 bool Unchecked : 1;
667#endif
668};
669
670/// Report a serious error, calling any installed error handler. See
671/// ErrorHandling.h.
672LLVM_ATTRIBUTE_NORETURN__attribute__((noreturn)) void report_fatal_error(Error Err,
673 bool gen_crash_diag = true);
674
675/// Report a fatal error if Err is a failure value.
676///
677/// This function can be used to wrap calls to fallible functions ONLY when it
678/// is known that the Error will always be a success value. E.g.
679///
680/// @code{.cpp}
681/// // foo only attempts the fallible operation if DoFallibleOperation is
682/// // true. If DoFallibleOperation is false then foo always returns
683/// // Error::success().
684/// Error foo(bool DoFallibleOperation);
685///
686/// cantFail(foo(false));
687/// @endcode
688inline void cantFail(Error Err, const char *Msg = nullptr) {
689 if (Err) {
690 if (!Msg)
691 Msg = "Failure value returned from cantFail wrapped call";
692 llvm_unreachable(Msg)::llvm::llvm_unreachable_internal(Msg, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 692);
693 }
694}
695
696/// Report a fatal error if ValOrErr is a failure value, otherwise unwraps and
697/// returns the contained value.
698///
699/// This function can be used to wrap calls to fallible functions ONLY when it
700/// is known that the Error will always be a success value. E.g.
701///
702/// @code{.cpp}
703/// // foo only attempts the fallible operation if DoFallibleOperation is
704/// // true. If DoFallibleOperation is false then foo always returns an int.
705/// Expected<int> foo(bool DoFallibleOperation);
706///
707/// int X = cantFail(foo(false));
708/// @endcode
709template <typename T>
710T cantFail(Expected<T> ValOrErr, const char *Msg = nullptr) {
711 if (ValOrErr)
712 return std::move(*ValOrErr);
713 else {
714 if (!Msg)
715 Msg = "Failure value returned from cantFail wrapped call";
716 llvm_unreachable(Msg)::llvm::llvm_unreachable_internal(Msg, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 716);
717 }
718}
719
720/// Report a fatal error if ValOrErr is a failure value, otherwise unwraps and
721/// returns the contained reference.
722///
723/// This function can be used to wrap calls to fallible functions ONLY when it
724/// is known that the Error will always be a success value. E.g.
725///
726/// @code{.cpp}
727/// // foo only attempts the fallible operation if DoFallibleOperation is
728/// // true. If DoFallibleOperation is false then foo always returns a Bar&.
729/// Expected<Bar&> foo(bool DoFallibleOperation);
730///
731/// Bar &X = cantFail(foo(false));
732/// @endcode
733template <typename T>
734T& cantFail(Expected<T&> ValOrErr, const char *Msg = nullptr) {
735 if (ValOrErr)
736 return *ValOrErr;
737 else {
738 if (!Msg)
739 Msg = "Failure value returned from cantFail wrapped call";
740 llvm_unreachable(Msg)::llvm::llvm_unreachable_internal(Msg, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 740);
741 }
742}
743
744/// Helper for testing applicability of, and applying, handlers for
745/// ErrorInfo types.
746template <typename HandlerT>
747class ErrorHandlerTraits
748 : public ErrorHandlerTraits<decltype(
749 &std::remove_reference<HandlerT>::type::operator())> {};
750
751// Specialization functions of the form 'Error (const ErrT&)'.
752template <typename ErrT> class ErrorHandlerTraits<Error (&)(ErrT &)> {
753public:
754 static bool appliesTo(const ErrorInfoBase &E) {
755 return E.template isA<ErrT>();
756 }
757
758 template <typename HandlerT>
759 static Error apply(HandlerT &&H, std::unique_ptr<ErrorInfoBase> E) {
760 assert(appliesTo(*E) && "Applying incorrect handler")(static_cast <bool> (appliesTo(*E) && "Applying incorrect handler"
) ? void (0) : __assert_fail ("appliesTo(*E) && \"Applying incorrect handler\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 760, __extension__ __PRETTY_FUNCTION__));
761 return H(static_cast<ErrT &>(*E));
762 }
763};
764
765// Specialization functions of the form 'void (const ErrT&)'.
766template <typename ErrT> class ErrorHandlerTraits<void (&)(ErrT &)> {
767public:
768 static bool appliesTo(const ErrorInfoBase &E) {
769 return E.template isA<ErrT>();
770 }
771
772 template <typename HandlerT>
773 static Error apply(HandlerT &&H, std::unique_ptr<ErrorInfoBase> E) {
774 assert(appliesTo(*E) && "Applying incorrect handler")(static_cast <bool> (appliesTo(*E) && "Applying incorrect handler"
) ? void (0) : __assert_fail ("appliesTo(*E) && \"Applying incorrect handler\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 774, __extension__ __PRETTY_FUNCTION__));
775 H(static_cast<ErrT &>(*E));
776 return Error::success();
777 }
778};
779
780/// Specialization for functions of the form 'Error (std::unique_ptr<ErrT>)'.
781template <typename ErrT>
782class ErrorHandlerTraits<Error (&)(std::unique_ptr<ErrT>)> {
783public:
784 static bool appliesTo(const ErrorInfoBase &E) {
785 return E.template isA<ErrT>();
786 }
787
788 template <typename HandlerT>
789 static Error apply(HandlerT &&H, std::unique_ptr<ErrorInfoBase> E) {
790 assert(appliesTo(*E) && "Applying incorrect handler")(static_cast <bool> (appliesTo(*E) && "Applying incorrect handler"
) ? void (0) : __assert_fail ("appliesTo(*E) && \"Applying incorrect handler\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 790, __extension__ __PRETTY_FUNCTION__));
791 std::unique_ptr<ErrT> SubE(static_cast<ErrT *>(E.release()));
792 return H(std::move(SubE));
793 }
794};
795
796/// Specialization for functions of the form 'void (std::unique_ptr<ErrT>)'.
797template <typename ErrT>
798class ErrorHandlerTraits<void (&)(std::unique_ptr<ErrT>)> {
799public:
800 static bool appliesTo(const ErrorInfoBase &E) {
801 return E.template isA<ErrT>();
802 }
803
804 template <typename HandlerT>
805 static Error apply(HandlerT &&H, std::unique_ptr<ErrorInfoBase> E) {
806 assert(appliesTo(*E) && "Applying incorrect handler")(static_cast <bool> (appliesTo(*E) && "Applying incorrect handler"
) ? void (0) : __assert_fail ("appliesTo(*E) && \"Applying incorrect handler\""
, "/build/llvm-toolchain-snapshot-7~svn326246/include/llvm/Support/Error.h"
, 806, __extension__ __PRETTY_FUNCTION__));
807 std::unique_ptr<ErrT> SubE(static_cast<ErrT *>(E.release()));
808 H(std::move(SubE));
809 return Error::success();
810 }
811};
812
813// Specialization for member functions of the form 'RetT (const ErrT&)'.
814template <typename C, typename RetT, typename ErrT>
815class ErrorHandlerTraits<RetT (C::*)(ErrT &)>
816 : public ErrorHandlerTraits<RetT (&)(ErrT &)> {};
817
818// Specialization for member functions of the form 'RetT (const ErrT&) const'.
819template <typename C, typename RetT, typename ErrT>
820class ErrorHandlerTraits<RetT (C::*)(ErrT &) const>
821 : public ErrorHandlerTraits<RetT (&)(ErrT &)> {};
822
823// Specialization for member functions of the form 'RetT (const ErrT&)'.
824template <typename C, typename RetT, typename ErrT>
825class ErrorHandlerTraits<RetT (C::*)(const ErrT &)>
826 : public ErrorHandlerTraits<RetT (&)(ErrT &)> {};
827
828// Specialization for member functions of the form 'RetT (const ErrT&) const'.
829template <typename C, typename RetT, typename ErrT>
830class ErrorHandlerTraits<RetT (C::*)(const ErrT &) const>
831 : public ErrorHandlerTraits<RetT (&)(ErrT &)> {};
832
833/// Specialization for member functions of the form
834/// 'RetT (std::unique_ptr<ErrT>)'.
835template <typename C, typename RetT, typename ErrT>
836class ErrorHandlerTraits<RetT (C::*)(std::unique_ptr<ErrT>)>
837 : public ErrorHandlerTraits<RetT (&)(std::unique_ptr<ErrT>)> {};
838
839/// Specialization for member functions of the form
840/// 'RetT (std::unique_ptr<ErrT>) const'.
841template <typename C, typename RetT, typename ErrT>
842class ErrorHandlerTraits<RetT (C::*)(std::unique_ptr<ErrT>) const>
843 : public ErrorHandlerTraits<RetT (&)(std::unique_ptr<ErrT>)> {};
844
845inline Error handleErrorImpl(std::unique_ptr<ErrorInfoBase> Payload) {
846 return Error(std::move(Payload));
847}
848
849template <typename HandlerT, typename... HandlerTs>
850Error handleErrorImpl(std::unique_ptr<ErrorInfoBase> Payload,
851 HandlerT &&Handler, HandlerTs &&... Handlers) {
852 if (ErrorHandlerTraits<HandlerT>::appliesTo(*Payload))
853 return ErrorHandlerTraits<HandlerT>::apply(std::forward<HandlerT>(Handler),
854 std::move(Payload));
855 return handleErrorImpl(std::move(Payload),
856 std::forward<HandlerTs>(Handlers)...);
857}
858
859/// Pass the ErrorInfo(s) contained in E to their respective handlers. Any
860/// unhandled errors (or Errors returned by handlers) are re-concatenated and
861/// returned.
862/// Because this function returns an error, its result must also be checked
863/// or returned. If you intend to handle all errors use handleAllErrors
864/// (which returns void, and will abort() on unhandled errors) instead.
865template <typename... HandlerTs>
866Error handleErrors(Error E, HandlerTs &&... Hs) {
867 if (!E)
868 return Error::success();
869
870 std::unique_ptr<ErrorInfoBase> Payload = E.takePayload();
871
872 if (Payload->isA<ErrorList>()) {
873 ErrorList &List = static_cast<ErrorList &>(*Payload);
874 Error R;
875 for (auto &P : List.Payloads)
876 R = ErrorList::join(
877 std::move(R),
878 handleErrorImpl(std::move(P), std::forward<HandlerTs>(Hs)...));
879 return R;
880 }
881
882 return handleErrorImpl(std::move(Payload), std::forward<HandlerTs>(Hs)...);
883}
884
885/// Behaves the same as handleErrors, except that it requires that all
886/// errors be handled by the given handlers. If any unhandled error remains
887/// after the handlers have run, report_fatal_error() will be called.
888template <typename... HandlerTs>
889void handleAllErrors(Error E, HandlerTs &&... Handlers) {
890 cantFail(handleErrors(std::move(E), std::forward<HandlerTs>(Handlers)...));
891}
892
893/// Check that E is a non-error, then drop it.
894/// If E is an error report_fatal_error will be called.
895inline void handleAllErrors(Error E) {
896 cantFail(std::move(E));
897}
898
899/// Handle any errors (if present) in an Expected<T>, then try a recovery path.
900///
901/// If the incoming value is a success value it is returned unmodified. If it
902/// is a failure value then it the contained error is passed to handleErrors.
903/// If handleErrors is able to handle the error then the RecoveryPath functor
904/// is called to supply the final result. If handleErrors is not able to
905/// handle all errors then the unhandled errors are returned.
906///
907/// This utility enables the follow pattern:
908///
909/// @code{.cpp}
910/// enum FooStrategy { Aggressive, Conservative };
911/// Expected<Foo> foo(FooStrategy S);
912///
913/// auto ResultOrErr =
914/// handleExpected(
915/// foo(Aggressive),
916/// []() { return foo(Conservative); },
917/// [](AggressiveStrategyError&) {
918/// // Implicitly conusme this - we'll recover by using a conservative
919/// // strategy.
920/// });
921///
922/// @endcode
923template <typename T, typename RecoveryFtor, typename... HandlerTs>
924Expected<T> handleExpected(Expected<T> ValOrErr, RecoveryFtor &&RecoveryPath,
925 HandlerTs &&... Handlers) {
926 if (ValOrErr)
927 return ValOrErr;
928
929 if (auto Err = handleErrors(ValOrErr.takeError(),
930 std::forward<HandlerTs>(Handlers)...))
931 return std::move(Err);
932
933 return RecoveryPath();
934}
935
936/// Log all errors (if any) in E to OS. If there are any errors, ErrorBanner
937/// will be printed before the first one is logged. A newline will be printed
938/// after each error.
939///
940/// This is useful in the base level of your program to allow clean termination
941/// (allowing clean deallocation of resources, etc.), while reporting error
942/// information to the user.
943void logAllUnhandledErrors(Error E, raw_ostream &OS, Twine ErrorBanner);
944
945/// Write all error messages (if any) in E to a string. The newline character
946/// is used to separate error messages.
947inline std::string toString(Error E) {
948 SmallVector<std::string, 2> Errors;
949 handleAllErrors(std::move(E), [&Errors](const ErrorInfoBase &EI) {
950 Errors.push_back(EI.message());
951 });
952 return join(Errors.begin(), Errors.end(), "\n");
953}
954
955/// Consume a Error without doing anything. This method should be used
956/// only where an error can be considered a reasonable and expected return
957/// value.
958///
959/// Uses of this method are potentially indicative of design problems: If it's
960/// legitimate to do nothing while processing an "error", the error-producer
961/// might be more clearly refactored to return an Optional<T>.
962inline void consumeError(Error Err) {
963 handleAllErrors(std::move(Err), [](const ErrorInfoBase &) {});
964}
965
966/// Helper for converting an Error to a bool.
967///
968/// This method returns true if Err is in an error state, or false if it is
969/// in a success state. Puts Err in a checked state in both cases (unlike
970/// Error::operator bool(), which only does this for success states).
971inline bool errorToBool(Error Err) {
972 bool IsError = static_cast<bool>(Err);
973 if (IsError)
974 consumeError(std::move(Err));
975 return IsError;
976}
977
978/// Helper for Errors used as out-parameters.
979///
980/// This helper is for use with the Error-as-out-parameter idiom, where an error
981/// is passed to a function or method by reference, rather than being returned.
982/// In such cases it is helpful to set the checked bit on entry to the function
983/// so that the error can be written to (unchecked Errors abort on assignment)
984/// and clear the checked bit on exit so that clients cannot accidentally forget
985/// to check the result. This helper performs these actions automatically using
986/// RAII:
987///
988/// @code{.cpp}
989/// Result foo(Error &Err) {
990/// ErrorAsOutParameter ErrAsOutParam(&Err); // 'Checked' flag set
991/// // <body of foo>
992/// // <- 'Checked' flag auto-cleared when ErrAsOutParam is destructed.
993/// }
994/// @endcode
995///
996/// ErrorAsOutParameter takes an Error* rather than Error& so that it can be
997/// used with optional Errors (Error pointers that are allowed to be null). If
998/// ErrorAsOutParameter took an Error reference, an instance would have to be
999/// created inside every condition that verified that Error was non-null. By
1000/// taking an Error pointer we can just create one instance at the top of the
1001/// function.
1002class ErrorAsOutParameter {
1003public:
1004 ErrorAsOutParameter(Error *Err) : Err(Err) {
1005 // Raise the checked bit if Err is success.
1006 if (Err)
1007 (void)!!*Err;
1008 }
1009
1010 ~ErrorAsOutParameter() {
1011 // Clear the checked bit.
1012 if (Err && !*Err)
1013 *Err = Error::success();
1014 }
1015
1016private:
1017 Error *Err;
1018};
1019
1020/// Helper for Expected<T>s used as out-parameters.
1021///
1022/// See ErrorAsOutParameter.
1023template <typename T>
1024class ExpectedAsOutParameter {
1025public:
1026 ExpectedAsOutParameter(Expected<T> *ValOrErr)
1027 : ValOrErr(ValOrErr) {
1028 if (ValOrErr)
1029 (void)!!*ValOrErr;
1030 }
1031
1032 ~ExpectedAsOutParameter() {
1033 if (ValOrErr)
1034 ValOrErr->setUnchecked();
1035 }
1036
1037private:
1038 Expected<T> *ValOrErr;
1039};
1040
1041/// This class wraps a std::error_code in a Error.
1042///
1043/// This is useful if you're writing an interface that returns a Error
1044/// (or Expected) and you want to call code that still returns
1045/// std::error_codes.
1046class ECError : public ErrorInfo<ECError> {
1047 friend Error errorCodeToError(std::error_code);
1048
1049public:
1050 void setErrorCode(std::error_code EC) { this->EC = EC; }
1051 std::error_code convertToErrorCode() const override { return EC; }
1052 void log(raw_ostream &OS) const override { OS << EC.message(); }
1053
1054 // Used by ErrorInfo::classID.
1055 static char ID;
1056
1057protected:
1058 ECError() = default;
1059 ECError(std::error_code EC) : EC(EC) {}
1060
1061 std::error_code EC;
1062};
1063
1064/// The value returned by this function can be returned from convertToErrorCode
1065/// for Error values where no sensible translation to std::error_code exists.
1066/// It should only be used in this situation, and should never be used where a
1067/// sensible conversion to std::error_code is available, as attempts to convert
1068/// to/from this error will result in a fatal error. (i.e. it is a programmatic
1069///error to try to convert such a value).
1070std::error_code inconvertibleErrorCode();
1071
1072/// Helper for converting an std::error_code to a Error.
1073Error errorCodeToError(std::error_code EC);
1074
1075/// Helper for converting an ECError to a std::error_code.
1076///
1077/// This method requires that Err be Error() or an ECError, otherwise it
1078/// will trigger a call to abort().
1079std::error_code errorToErrorCode(Error Err);
1080
1081/// Convert an ErrorOr<T> to an Expected<T>.
1082template <typename T> Expected<T> errorOrToExpected(ErrorOr<T> &&EO) {
1083 if (auto EC = EO.getError())
1084 return errorCodeToError(EC);
1085 return std::move(*EO);
1086}
1087
1088/// Convert an Expected<T> to an ErrorOr<T>.
1089template <typename T> ErrorOr<T> expectedToErrorOr(Expected<T> &&E) {
1090 if (auto Err = E.takeError())
1091 return errorToErrorCode(std::move(Err));
1092 return std::move(*E);
1093}
1094
1095/// This class wraps a string in an Error.
1096///
1097/// StringError is useful in cases where the client is not expected to be able
1098/// to consume the specific error message programmatically (for example, if the
1099/// error message is to be presented to the user).
1100class StringError : public ErrorInfo<StringError> {
1101public:
1102 static char ID;
1103
1104 StringError(const Twine &S, std::error_code EC);
1105
1106 void log(raw_ostream &OS) const override;
1107 std::error_code convertToErrorCode() const override;
1108
1109 const std::string &getMessage() const { return Msg; }
1110
1111private:
1112 std::string Msg;
1113 std::error_code EC;
1114};
1115
1116/// Helper for check-and-exit error handling.
1117///
1118/// For tool use only. NOT FOR USE IN LIBRARY CODE.
1119///
1120class ExitOnError {
1121public:
1122 /// Create an error on exit helper.
1123 ExitOnError(std::string Banner = "", int DefaultErrorExitCode = 1)
1124 : Banner(std::move(Banner)),
1125 GetExitCode([=](const Error &) { return DefaultErrorExitCode; }) {}
1126
1127 /// Set the banner string for any errors caught by operator().
1128 void setBanner(std::string Banner) { this->Banner = std::move(Banner); }
1129
1130 /// Set the exit-code mapper function.
1131 void setExitCodeMapper(std::function<int(const Error &)> GetExitCode) {
1132 this->GetExitCode = std::move(GetExitCode);
1133 }
1134
1135 /// Check Err. If it's in a failure state log the error(s) and exit.
1136 void operator()(Error Err) const { checkError(std::move(Err)); }
1137
1138 /// Check E. If it's in a success state then return the contained value. If
1139 /// it's in a failure state log the error(s) and exit.
1140 template <typename T> T operator()(Expected<T> &&E) const {
1141 checkError(E.takeError());
1142 return std::move(*E);
1143 }
1144
1145 /// Check E. If it's in a success state then return the contained reference. If
1146 /// it's in a failure state log the error(s) and exit.
1147 template <typename T> T& operator()(Expected<T&> &&E) const {
1148 checkError(E.takeError());
1149 return *E;
1150 }
1151
1152private:
1153 void checkError(Error Err) const {
1154 if (Err) {
1155 int ExitCode = GetExitCode(Err);
1156 logAllUnhandledErrors(std::move(Err), errs(), Banner);
1157 exit(ExitCode);
1158 }
1159 }
1160
1161 std::string Banner;
1162 std::function<int(const Error &)> GetExitCode;
1163};
1164
1165} // end namespace llvm
1166
1167#endif // LLVM_SUPPORT_ERROR_H