Bug Summary

File:lib/ObjectYAML/MinidumpYAML.cpp
Warning:line 378, column 9
1st function call argument is an uninitialized 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 MinidumpYAML.cpp -analyzer-store=region -analyzer-opt-analyze-nested-blocks -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 -analyzer-config-compatibility-mode=true -mrelocation-model pic -pic-level 2 -mthread-model posix -mframe-pointer=none -fmath-errno -masm-verbose -mconstructor-aliases -munwind-tables -fuse-init-array -target-cpu x86-64 -dwarf-column-info -debugger-tuning=gdb -ffunction-sections -fdata-sections -resource-dir /usr/lib/llvm-10/lib/clang/10.0.0 -D _DEBUG -D _GNU_SOURCE -D __STDC_CONSTANT_MACROS -D __STDC_FORMAT_MACROS -D __STDC_LIMIT_MACROS -I /build/llvm-toolchain-snapshot-10~svn374814/build-llvm/lib/ObjectYAML -I /build/llvm-toolchain-snapshot-10~svn374814/lib/ObjectYAML -I /build/llvm-toolchain-snapshot-10~svn374814/build-llvm/include -I /build/llvm-toolchain-snapshot-10~svn374814/include -U NDEBUG -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/6.3.0/../../../../include/c++/6.3.0 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/6.3.0/../../../../include/x86_64-linux-gnu/c++/6.3.0 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/6.3.0/../../../../include/x86_64-linux-gnu/c++/6.3.0 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/6.3.0/../../../../include/c++/6.3.0/backward -internal-isystem /usr/local/include -internal-isystem /usr/lib/llvm-10/lib/clang/10.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++14 -fdeprecated-macro -fdebug-compilation-dir /build/llvm-toolchain-snapshot-10~svn374814/build-llvm/lib/ObjectYAML -fdebug-prefix-map=/build/llvm-toolchain-snapshot-10~svn374814=. -ferror-limit 19 -fmessage-length 0 -fvisibility-inlines-hidden -stack-protector 2 -fgnuc-version=4.2.1 -fobjc-runtime=gcc -fdiagnostics-show-option -vectorize-loops -vectorize-slp -analyzer-output=html -analyzer-config stable-report-filename=true -faddrsig -o /tmp/scan-build-2019-10-15-035155-28452-1 -x c++ /build/llvm-toolchain-snapshot-10~svn374814/lib/ObjectYAML/MinidumpYAML.cpp

/build/llvm-toolchain-snapshot-10~svn374814/lib/ObjectYAML/MinidumpYAML.cpp

1//===- MinidumpYAML.cpp - Minidump YAMLIO implementation ------------------===//
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#include "llvm/ObjectYAML/MinidumpYAML.h"
10#include "llvm/Support/Allocator.h"
11
12using namespace llvm;
13using namespace llvm::MinidumpYAML;
14using namespace llvm::minidump;
15
16/// Perform an optional yaml-mapping of an endian-aware type EndianType. The
17/// only purpose of this function is to avoid casting the Default value to the
18/// endian type;
19template <typename EndianType>
20static inline void mapOptional(yaml::IO &IO, const char *Key, EndianType &Val,
21 typename EndianType::value_type Default) {
22 IO.mapOptional(Key, Val, EndianType(Default));
23}
24
25/// Yaml-map an endian-aware type EndianType as some other type MapType.
26template <typename MapType, typename EndianType>
27static inline void mapRequiredAs(yaml::IO &IO, const char *Key,
28 EndianType &Val) {
29 MapType Mapped = static_cast<typename EndianType::value_type>(Val);
30 IO.mapRequired(Key, Mapped);
31 Val = static_cast<typename EndianType::value_type>(Mapped);
32}
33
34/// Perform an optional yaml-mapping of an endian-aware type EndianType as some
35/// other type MapType.
36template <typename MapType, typename EndianType>
37static inline void mapOptionalAs(yaml::IO &IO, const char *Key, EndianType &Val,
38 MapType Default) {
39 MapType Mapped = static_cast<typename EndianType::value_type>(Val);
40 IO.mapOptional(Key, Mapped, Default);
41 Val = static_cast<typename EndianType::value_type>(Mapped);
42}
43
44namespace {
45/// Return the appropriate yaml Hex type for a given endian-aware type.
46template <typename EndianType> struct HexType;
47template <> struct HexType<support::ulittle16_t> { using type = yaml::Hex16; };
48template <> struct HexType<support::ulittle32_t> { using type = yaml::Hex32; };
49template <> struct HexType<support::ulittle64_t> { using type = yaml::Hex64; };
50} // namespace
51
52/// Yaml-map an endian-aware type as an appropriately-sized hex value.
53template <typename EndianType>
54static inline void mapRequiredHex(yaml::IO &IO, const char *Key,
55 EndianType &Val) {
56 mapRequiredAs<typename HexType<EndianType>::type>(IO, Key, Val);
57}
58
59/// Perform an optional yaml-mapping of an endian-aware type as an
60/// appropriately-sized hex value.
61template <typename EndianType>
62static inline void mapOptionalHex(yaml::IO &IO, const char *Key,
63 EndianType &Val,
64 typename EndianType::value_type Default) {
65 mapOptionalAs<typename HexType<EndianType>::type>(IO, Key, Val, Default);
66}
67
68Stream::~Stream() = default;
69
70Stream::StreamKind Stream::getKind(StreamType Type) {
71 switch (Type) {
72 case StreamType::MemoryInfoList:
73 return StreamKind::MemoryInfoList;
74 case StreamType::MemoryList:
75 return StreamKind::MemoryList;
76 case StreamType::ModuleList:
77 return StreamKind::ModuleList;
78 case StreamType::SystemInfo:
79 return StreamKind::SystemInfo;
80 case StreamType::LinuxCPUInfo:
81 case StreamType::LinuxProcStatus:
82 case StreamType::LinuxLSBRelease:
83 case StreamType::LinuxCMDLine:
84 case StreamType::LinuxMaps:
85 case StreamType::LinuxProcStat:
86 case StreamType::LinuxProcUptime:
87 return StreamKind::TextContent;
88 case StreamType::ThreadList:
89 return StreamKind::ThreadList;
90 default:
91 return StreamKind::RawContent;
92 }
93}
94
95std::unique_ptr<Stream> Stream::create(StreamType Type) {
96 StreamKind Kind = getKind(Type);
97 switch (Kind) {
98 case StreamKind::MemoryInfoList:
99 return std::make_unique<MemoryInfoListStream>();
100 case StreamKind::MemoryList:
101 return std::make_unique<MemoryListStream>();
102 case StreamKind::ModuleList:
103 return std::make_unique<ModuleListStream>();
104 case StreamKind::RawContent:
105 return std::make_unique<RawContentStream>(Type);
106 case StreamKind::SystemInfo:
107 return std::make_unique<SystemInfoStream>();
108 case StreamKind::TextContent:
109 return std::make_unique<TextContentStream>(Type);
110 case StreamKind::ThreadList:
111 return std::make_unique<ThreadListStream>();
112 }
113 llvm_unreachable("Unhandled stream kind!")::llvm::llvm_unreachable_internal("Unhandled stream kind!", "/build/llvm-toolchain-snapshot-10~svn374814/lib/ObjectYAML/MinidumpYAML.cpp"
, 113)
;
114}
115
116void yaml::ScalarBitSetTraits<MemoryProtection>::bitset(
117 IO &IO, MemoryProtection &Protect) {
118#define HANDLE_MDMP_PROTECT(CODE, NAME, NATIVENAME) \
119 IO.bitSetCase(Protect, #NATIVENAME, MemoryProtection::NAME);
120#include "llvm/BinaryFormat/MinidumpConstants.def"
121}
122
123void yaml::ScalarBitSetTraits<MemoryState>::bitset(IO &IO, MemoryState &State) {
124#define HANDLE_MDMP_MEMSTATE(CODE, NAME, NATIVENAME) \
125 IO.bitSetCase(State, #NATIVENAME, MemoryState::NAME);
126#include "llvm/BinaryFormat/MinidumpConstants.def"
127}
128
129void yaml::ScalarBitSetTraits<MemoryType>::bitset(IO &IO, MemoryType &Type) {
130#define HANDLE_MDMP_MEMTYPE(CODE, NAME, NATIVENAME) \
131 IO.bitSetCase(Type, #NATIVENAME, MemoryType::NAME);
132#include "llvm/BinaryFormat/MinidumpConstants.def"
133}
134
135void yaml::ScalarEnumerationTraits<ProcessorArchitecture>::enumeration(
136 IO &IO, ProcessorArchitecture &Arch) {
137#define HANDLE_MDMP_ARCH(CODE, NAME) \
138 IO.enumCase(Arch, #NAME, ProcessorArchitecture::NAME);
139#include "llvm/BinaryFormat/MinidumpConstants.def"
140 IO.enumFallback<Hex16>(Arch);
141}
142
143void yaml::ScalarEnumerationTraits<OSPlatform>::enumeration(IO &IO,
144 OSPlatform &Plat) {
145#define HANDLE_MDMP_PLATFORM(CODE, NAME) \
146 IO.enumCase(Plat, #NAME, OSPlatform::NAME);
147#include "llvm/BinaryFormat/MinidumpConstants.def"
148 IO.enumFallback<Hex32>(Plat);
149}
150
151void yaml::ScalarEnumerationTraits<StreamType>::enumeration(IO &IO,
152 StreamType &Type) {
153#define HANDLE_MDMP_STREAM_TYPE(CODE, NAME) \
154 IO.enumCase(Type, #NAME, StreamType::NAME);
155#include "llvm/BinaryFormat/MinidumpConstants.def"
156 IO.enumFallback<Hex32>(Type);
157}
158
159void yaml::MappingTraits<CPUInfo::ArmInfo>::mapping(IO &IO,
160 CPUInfo::ArmInfo &Info) {
161 mapRequiredHex(IO, "CPUID", Info.CPUID);
162 mapOptionalHex(IO, "ELF hwcaps", Info.ElfHWCaps, 0);
163}
164
165namespace {
166template <std::size_t N> struct FixedSizeHex {
167 FixedSizeHex(uint8_t (&Storage)[N]) : Storage(Storage) {}
168
169 uint8_t (&Storage)[N];
170};
171} // namespace
172
173namespace llvm {
174namespace yaml {
175template <std::size_t N> struct ScalarTraits<FixedSizeHex<N>> {
176 static void output(const FixedSizeHex<N> &Fixed, void *, raw_ostream &OS) {
177 OS << toHex(makeArrayRef(Fixed.Storage));
178 }
179
180 static StringRef input(StringRef Scalar, void *, FixedSizeHex<N> &Fixed) {
181 if (!all_of(Scalar, isHexDigit))
182 return "Invalid hex digit in input";
183 if (Scalar.size() < 2 * N)
184 return "String too short";
185 if (Scalar.size() > 2 * N)
186 return "String too long";
187 copy(fromHex(Scalar), Fixed.Storage);
188 return "";
189 }
190
191 static QuotingType mustQuote(StringRef S) { return QuotingType::None; }
192};
193} // namespace yaml
194} // namespace llvm
195void yaml::MappingTraits<CPUInfo::OtherInfo>::mapping(
196 IO &IO, CPUInfo::OtherInfo &Info) {
197 FixedSizeHex<sizeof(Info.ProcessorFeatures)> Features(Info.ProcessorFeatures);
198 IO.mapRequired("Features", Features);
199}
200
201namespace {
202/// A type which only accepts strings of a fixed size for yaml conversion.
203template <std::size_t N> struct FixedSizeString {
204 FixedSizeString(char (&Storage)[N]) : Storage(Storage) {}
205
206 char (&Storage)[N];
207};
208} // namespace
209
210namespace llvm {
211namespace yaml {
212template <std::size_t N> struct ScalarTraits<FixedSizeString<N>> {
213 static void output(const FixedSizeString<N> &Fixed, void *, raw_ostream &OS) {
214 OS << StringRef(Fixed.Storage, N);
215 }
216
217 static StringRef input(StringRef Scalar, void *, FixedSizeString<N> &Fixed) {
218 if (Scalar.size() < N)
219 return "String too short";
220 if (Scalar.size() > N)
221 return "String too long";
222 copy(Scalar, Fixed.Storage);
223 return "";
224 }
225
226 static QuotingType mustQuote(StringRef S) { return needsQuotes(S); }
227};
228} // namespace yaml
229} // namespace llvm
230
231void yaml::MappingTraits<CPUInfo::X86Info>::mapping(IO &IO,
232 CPUInfo::X86Info &Info) {
233 FixedSizeString<sizeof(Info.VendorID)> VendorID(Info.VendorID);
234 IO.mapRequired("Vendor ID", VendorID);
235
236 mapRequiredHex(IO, "Version Info", Info.VersionInfo);
237 mapRequiredHex(IO, "Feature Info", Info.FeatureInfo);
238 mapOptionalHex(IO, "AMD Extended Features", Info.AMDExtendedFeatures, 0);
239}
240
241void yaml::MappingTraits<MemoryInfo>::mapping(IO &IO, MemoryInfo &Info) {
242 mapRequiredHex(IO, "Base Address", Info.BaseAddress);
243 mapOptionalHex(IO, "Allocation Base", Info.AllocationBase, Info.BaseAddress);
244 mapRequiredAs<MemoryProtection>(IO, "Allocation Protect",
245 Info.AllocationProtect);
246 mapOptionalHex(IO, "Reserved0", Info.Reserved0, 0);
247 mapRequiredHex(IO, "Region Size", Info.RegionSize);
248 mapRequiredAs<MemoryState>(IO, "State", Info.State);
249 mapOptionalAs<MemoryProtection>(IO, "Protect", Info.Protect,
250 Info.AllocationProtect);
251 mapRequiredAs<MemoryType>(IO, "Type", Info.Type);
252 mapOptionalHex(IO, "Reserved1", Info.Reserved1, 0);
253}
254
255void yaml::MappingTraits<VSFixedFileInfo>::mapping(IO &IO,
256 VSFixedFileInfo &Info) {
257 mapOptionalHex(IO, "Signature", Info.Signature, 0);
258 mapOptionalHex(IO, "Struct Version", Info.StructVersion, 0);
259 mapOptionalHex(IO, "File Version High", Info.FileVersionHigh, 0);
260 mapOptionalHex(IO, "File Version Low", Info.FileVersionLow, 0);
261 mapOptionalHex(IO, "Product Version High", Info.ProductVersionHigh, 0);
262 mapOptionalHex(IO, "Product Version Low", Info.ProductVersionLow, 0);
263 mapOptionalHex(IO, "File Flags Mask", Info.FileFlagsMask, 0);
264 mapOptionalHex(IO, "File Flags", Info.FileFlags, 0);
265 mapOptionalHex(IO, "File OS", Info.FileOS, 0);
266 mapOptionalHex(IO, "File Type", Info.FileType, 0);
267 mapOptionalHex(IO, "File Subtype", Info.FileSubtype, 0);
268 mapOptionalHex(IO, "File Date High", Info.FileDateHigh, 0);
269 mapOptionalHex(IO, "File Date Low", Info.FileDateLow, 0);
270}
271
272void yaml::MappingTraits<ModuleListStream::entry_type>::mapping(
273 IO &IO, ModuleListStream::entry_type &M) {
274 mapRequiredHex(IO, "Base of Image", M.Entry.BaseOfImage);
275 mapRequiredHex(IO, "Size of Image", M.Entry.SizeOfImage);
276 mapOptionalHex(IO, "Checksum", M.Entry.Checksum, 0);
277 IO.mapOptional("Time Date Stamp", M.Entry.TimeDateStamp,
278 support::ulittle32_t(0));
279 IO.mapRequired("Module Name", M.Name);
280 IO.mapOptional("Version Info", M.Entry.VersionInfo, VSFixedFileInfo());
281 IO.mapRequired("CodeView Record", M.CvRecord);
282 IO.mapOptional("Misc Record", M.MiscRecord, yaml::BinaryRef());
283 mapOptionalHex(IO, "Reserved0", M.Entry.Reserved0, 0);
284 mapOptionalHex(IO, "Reserved1", M.Entry.Reserved1, 0);
285}
286
287static void streamMapping(yaml::IO &IO, RawContentStream &Stream) {
288 IO.mapOptional("Content", Stream.Content);
289 IO.mapOptional("Size", Stream.Size, Stream.Content.binary_size());
290}
291
292static StringRef streamValidate(RawContentStream &Stream) {
293 if (Stream.Size.value < Stream.Content.binary_size())
294 return "Stream size must be greater or equal to the content size";
295 return "";
296}
297
298void yaml::MappingTraits<MemoryListStream::entry_type>::mapping(
299 IO &IO, MemoryListStream::entry_type &Range) {
300 MappingContextTraits<MemoryDescriptor, yaml::BinaryRef>::mapping(
301 IO, Range.Entry, Range.Content);
302}
303
304static void streamMapping(yaml::IO &IO, MemoryInfoListStream &Stream) {
305 IO.mapRequired("Memory Ranges", Stream.Infos);
306}
307
308static void streamMapping(yaml::IO &IO, MemoryListStream &Stream) {
309 IO.mapRequired("Memory Ranges", Stream.Entries);
310}
311
312static void streamMapping(yaml::IO &IO, ModuleListStream &Stream) {
313 IO.mapRequired("Modules", Stream.Entries);
314}
315
316static void streamMapping(yaml::IO &IO, SystemInfoStream &Stream) {
317 SystemInfo &Info = Stream.Info;
318 IO.mapRequired("Processor Arch", Info.ProcessorArch);
319 mapOptional(IO, "Processor Level", Info.ProcessorLevel, 0);
320 mapOptional(IO, "Processor Revision", Info.ProcessorRevision, 0);
321 IO.mapOptional("Number of Processors", Info.NumberOfProcessors, 0);
322 IO.mapOptional("Product type", Info.ProductType, 0);
323 mapOptional(IO, "Major Version", Info.MajorVersion, 0);
324 mapOptional(IO, "Minor Version", Info.MinorVersion, 0);
325 mapOptional(IO, "Build Number", Info.BuildNumber, 0);
326 IO.mapRequired("Platform ID", Info.PlatformId);
327 IO.mapOptional("CSD Version", Stream.CSDVersion, "");
328 mapOptionalHex(IO, "Suite Mask", Info.SuiteMask, 0);
329 mapOptionalHex(IO, "Reserved", Info.Reserved, 0);
330 switch (static_cast<ProcessorArchitecture>(Info.ProcessorArch)) {
331 case ProcessorArchitecture::X86:
332 case ProcessorArchitecture::AMD64:
333 IO.mapOptional("CPU", Info.CPU.X86);
334 break;
335 case ProcessorArchitecture::ARM:
336 case ProcessorArchitecture::ARM64:
337 IO.mapOptional("CPU", Info.CPU.Arm);
338 break;
339 default:
340 IO.mapOptional("CPU", Info.CPU.Other);
341 break;
342 }
343}
344
345static void streamMapping(yaml::IO &IO, TextContentStream &Stream) {
346 IO.mapOptional("Text", Stream.Text);
347}
348
349void yaml::MappingContextTraits<MemoryDescriptor, yaml::BinaryRef>::mapping(
350 IO &IO, MemoryDescriptor &Memory, BinaryRef &Content) {
351 mapRequiredHex(IO, "Start of Memory Range", Memory.StartOfMemoryRange);
352 IO.mapRequired("Content", Content);
353}
354
355void yaml::MappingTraits<ThreadListStream::entry_type>::mapping(
356 IO &IO, ThreadListStream::entry_type &T) {
357 mapRequiredHex(IO, "Thread Id", T.Entry.ThreadId);
358 mapOptionalHex(IO, "Suspend Count", T.Entry.SuspendCount, 0);
359 mapOptionalHex(IO, "Priority Class", T.Entry.PriorityClass, 0);
360 mapOptionalHex(IO, "Priority", T.Entry.Priority, 0);
361 mapOptionalHex(IO, "Environment Block", T.Entry.EnvironmentBlock, 0);
362 IO.mapRequired("Context", T.Context);
363 IO.mapRequired("Stack", T.Entry.Stack, T.Stack);
364}
365
366static void streamMapping(yaml::IO &IO, ThreadListStream &Stream) {
367 IO.mapRequired("Threads", Stream.Entries);
368}
369
370void yaml::MappingTraits<std::unique_ptr<Stream>>::mapping(
371 yaml::IO &IO, std::unique_ptr<MinidumpYAML::Stream> &S) {
372 StreamType Type;
19
'Type' declared without an initial value
373 if (IO.outputting())
20
Assuming the condition is false
21
Taking false branch
374 Type = S->Type;
375 IO.mapRequired("Type", Type);
22
Calling 'IO::mapRequired'
29
Returning from 'IO::mapRequired'
376
377 if (!IO.outputting())
30
Assuming the condition is true
31
Taking true branch
378 S = MinidumpYAML::Stream::create(Type);
32
1st function call argument is an uninitialized value
379 switch (S->Kind) {
380 case MinidumpYAML::Stream::StreamKind::MemoryInfoList:
381 streamMapping(IO, llvm::cast<MemoryInfoListStream>(*S));
382 break;
383 case MinidumpYAML::Stream::StreamKind::MemoryList:
384 streamMapping(IO, llvm::cast<MemoryListStream>(*S));
385 break;
386 case MinidumpYAML::Stream::StreamKind::ModuleList:
387 streamMapping(IO, llvm::cast<ModuleListStream>(*S));
388 break;
389 case MinidumpYAML::Stream::StreamKind::RawContent:
390 streamMapping(IO, llvm::cast<RawContentStream>(*S));
391 break;
392 case MinidumpYAML::Stream::StreamKind::SystemInfo:
393 streamMapping(IO, llvm::cast<SystemInfoStream>(*S));
394 break;
395 case MinidumpYAML::Stream::StreamKind::TextContent:
396 streamMapping(IO, llvm::cast<TextContentStream>(*S));
397 break;
398 case MinidumpYAML::Stream::StreamKind::ThreadList:
399 streamMapping(IO, llvm::cast<ThreadListStream>(*S));
400 break;
401 }
402}
403
404StringRef yaml::MappingTraits<std::unique_ptr<Stream>>::validate(
405 yaml::IO &IO, std::unique_ptr<MinidumpYAML::Stream> &S) {
406 switch (S->Kind) {
407 case MinidumpYAML::Stream::StreamKind::RawContent:
408 return streamValidate(cast<RawContentStream>(*S));
409 case MinidumpYAML::Stream::StreamKind::MemoryInfoList:
410 case MinidumpYAML::Stream::StreamKind::MemoryList:
411 case MinidumpYAML::Stream::StreamKind::ModuleList:
412 case MinidumpYAML::Stream::StreamKind::SystemInfo:
413 case MinidumpYAML::Stream::StreamKind::TextContent:
414 case MinidumpYAML::Stream::StreamKind::ThreadList:
415 return "";
416 }
417 llvm_unreachable("Fully covered switch above!")::llvm::llvm_unreachable_internal("Fully covered switch above!"
, "/build/llvm-toolchain-snapshot-10~svn374814/lib/ObjectYAML/MinidumpYAML.cpp"
, 417)
;
418}
419
420void yaml::MappingTraits<Object>::mapping(IO &IO, Object &O) {
421 IO.mapTag("!minidump", true);
422 mapOptionalHex(IO, "Signature", O.Header.Signature, Header::MagicSignature);
423 mapOptionalHex(IO, "Version", O.Header.Version, Header::MagicVersion);
424 mapOptionalHex(IO, "Flags", O.Header.Flags, 0);
425 IO.mapRequired("Streams", O.Streams);
1
Calling 'IO::mapRequired'
426}
427
428Expected<std::unique_ptr<Stream>>
429Stream::create(const Directory &StreamDesc, const object::MinidumpFile &File) {
430 StreamKind Kind = getKind(StreamDesc.Type);
431 switch (Kind) {
432 case StreamKind::MemoryInfoList: {
433 if (auto ExpectedList = File.getMemoryInfoList())
434 return std::make_unique<MemoryInfoListStream>(*ExpectedList);
435 else
436 return ExpectedList.takeError();
437 }
438 case StreamKind::MemoryList: {
439 auto ExpectedList = File.getMemoryList();
440 if (!ExpectedList)
441 return ExpectedList.takeError();
442 std::vector<MemoryListStream::entry_type> Ranges;
443 for (const MemoryDescriptor &MD : *ExpectedList) {
444 auto ExpectedContent = File.getRawData(MD.Memory);
445 if (!ExpectedContent)
446 return ExpectedContent.takeError();
447 Ranges.push_back({MD, *ExpectedContent});
448 }
449 return std::make_unique<MemoryListStream>(std::move(Ranges));
450 }
451 case StreamKind::ModuleList: {
452 auto ExpectedList = File.getModuleList();
453 if (!ExpectedList)
454 return ExpectedList.takeError();
455 std::vector<ModuleListStream::entry_type> Modules;
456 for (const Module &M : *ExpectedList) {
457 auto ExpectedName = File.getString(M.ModuleNameRVA);
458 if (!ExpectedName)
459 return ExpectedName.takeError();
460 auto ExpectedCv = File.getRawData(M.CvRecord);
461 if (!ExpectedCv)
462 return ExpectedCv.takeError();
463 auto ExpectedMisc = File.getRawData(M.MiscRecord);
464 if (!ExpectedMisc)
465 return ExpectedMisc.takeError();
466 Modules.push_back(
467 {M, std::move(*ExpectedName), *ExpectedCv, *ExpectedMisc});
468 }
469 return std::make_unique<ModuleListStream>(std::move(Modules));
470 }
471 case StreamKind::RawContent:
472 return std::make_unique<RawContentStream>(StreamDesc.Type,
473 File.getRawStream(StreamDesc));
474 case StreamKind::SystemInfo: {
475 auto ExpectedInfo = File.getSystemInfo();
476 if (!ExpectedInfo)
477 return ExpectedInfo.takeError();
478 auto ExpectedCSDVersion = File.getString(ExpectedInfo->CSDVersionRVA);
479 if (!ExpectedCSDVersion)
480 return ExpectedInfo.takeError();
481 return std::make_unique<SystemInfoStream>(*ExpectedInfo,
482 std::move(*ExpectedCSDVersion));
483 }
484 case StreamKind::TextContent:
485 return std::make_unique<TextContentStream>(
486 StreamDesc.Type, toStringRef(File.getRawStream(StreamDesc)));
487 case StreamKind::ThreadList: {
488 auto ExpectedList = File.getThreadList();
489 if (!ExpectedList)
490 return ExpectedList.takeError();
491 std::vector<ThreadListStream::entry_type> Threads;
492 for (const Thread &T : *ExpectedList) {
493 auto ExpectedStack = File.getRawData(T.Stack.Memory);
494 if (!ExpectedStack)
495 return ExpectedStack.takeError();
496 auto ExpectedContext = File.getRawData(T.Context);
497 if (!ExpectedContext)
498 return ExpectedContext.takeError();
499 Threads.push_back({T, *ExpectedStack, *ExpectedContext});
500 }
501 return std::make_unique<ThreadListStream>(std::move(Threads));
502 }
503 }
504 llvm_unreachable("Unhandled stream kind!")::llvm::llvm_unreachable_internal("Unhandled stream kind!", "/build/llvm-toolchain-snapshot-10~svn374814/lib/ObjectYAML/MinidumpYAML.cpp"
, 504)
;
505}
506
507Expected<Object> Object::create(const object::MinidumpFile &File) {
508 std::vector<std::unique_ptr<Stream>> Streams;
509 Streams.reserve(File.streams().size());
510 for (const Directory &StreamDesc : File.streams()) {
511 auto ExpectedStream = Stream::create(StreamDesc, File);
512 if (!ExpectedStream)
513 return ExpectedStream.takeError();
514 Streams.push_back(std::move(*ExpectedStream));
515 }
516 return Object(File.header(), std::move(Streams));
517}

/build/llvm-toolchain-snapshot-10~svn374814/include/llvm/Support/YAMLTraits.h

1//===- llvm/Support/YAMLTraits.h --------------------------------*- 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_SUPPORT_YAMLTRAITS_H
10#define LLVM_SUPPORT_YAMLTRAITS_H
11
12#include "llvm/ADT/Optional.h"
13#include "llvm/ADT/SmallVector.h"
14#include "llvm/ADT/StringExtras.h"
15#include "llvm/ADT/StringMap.h"
16#include "llvm/ADT/StringRef.h"
17#include "llvm/ADT/Twine.h"
18#include "llvm/Support/AlignOf.h"
19#include "llvm/Support/Allocator.h"
20#include "llvm/Support/Endian.h"
21#include "llvm/Support/Regex.h"
22#include "llvm/Support/SourceMgr.h"
23#include "llvm/Support/YAMLParser.h"
24#include "llvm/Support/raw_ostream.h"
25#include <cassert>
26#include <cctype>
27#include <cstddef>
28#include <cstdint>
29#include <iterator>
30#include <map>
31#include <memory>
32#include <new>
33#include <string>
34#include <system_error>
35#include <type_traits>
36#include <vector>
37
38namespace llvm {
39namespace yaml {
40
41enum class NodeKind : uint8_t {
42 Scalar,
43 Map,
44 Sequence,
45};
46
47struct EmptyContext {};
48
49/// This class should be specialized by any type that needs to be converted
50/// to/from a YAML mapping. For example:
51///
52/// struct MappingTraits<MyStruct> {
53/// static void mapping(IO &io, MyStruct &s) {
54/// io.mapRequired("name", s.name);
55/// io.mapRequired("size", s.size);
56/// io.mapOptional("age", s.age);
57/// }
58/// };
59template<class T>
60struct MappingTraits {
61 // Must provide:
62 // static void mapping(IO &io, T &fields);
63 // Optionally may provide:
64 // static StringRef validate(IO &io, T &fields);
65 //
66 // The optional flow flag will cause generated YAML to use a flow mapping
67 // (e.g. { a: 0, b: 1 }):
68 // static const bool flow = true;
69};
70
71/// This class is similar to MappingTraits<T> but allows you to pass in
72/// additional context for each map operation. For example:
73///
74/// struct MappingContextTraits<MyStruct, MyContext> {
75/// static void mapping(IO &io, MyStruct &s, MyContext &c) {
76/// io.mapRequired("name", s.name);
77/// io.mapRequired("size", s.size);
78/// io.mapOptional("age", s.age);
79/// ++c.TimesMapped;
80/// }
81/// };
82template <class T, class Context> struct MappingContextTraits {
83 // Must provide:
84 // static void mapping(IO &io, T &fields, Context &Ctx);
85 // Optionally may provide:
86 // static StringRef validate(IO &io, T &fields, Context &Ctx);
87 //
88 // The optional flow flag will cause generated YAML to use a flow mapping
89 // (e.g. { a: 0, b: 1 }):
90 // static const bool flow = true;
91};
92
93/// This class should be specialized by any integral type that converts
94/// to/from a YAML scalar where there is a one-to-one mapping between
95/// in-memory values and a string in YAML. For example:
96///
97/// struct ScalarEnumerationTraits<Colors> {
98/// static void enumeration(IO &io, Colors &value) {
99/// io.enumCase(value, "red", cRed);
100/// io.enumCase(value, "blue", cBlue);
101/// io.enumCase(value, "green", cGreen);
102/// }
103/// };
104template <typename T, typename Enable = void> struct ScalarEnumerationTraits {
105 // Must provide:
106 // static void enumeration(IO &io, T &value);
107};
108
109/// This class should be specialized by any integer type that is a union
110/// of bit values and the YAML representation is a flow sequence of
111/// strings. For example:
112///
113/// struct ScalarBitSetTraits<MyFlags> {
114/// static void bitset(IO &io, MyFlags &value) {
115/// io.bitSetCase(value, "big", flagBig);
116/// io.bitSetCase(value, "flat", flagFlat);
117/// io.bitSetCase(value, "round", flagRound);
118/// }
119/// };
120template <typename T, typename Enable = void> struct ScalarBitSetTraits {
121 // Must provide:
122 // static void bitset(IO &io, T &value);
123};
124
125/// Describe which type of quotes should be used when quoting is necessary.
126/// Some non-printable characters need to be double-quoted, while some others
127/// are fine with simple-quoting, and some don't need any quoting.
128enum class QuotingType { None, Single, Double };
129
130/// This class should be specialized by type that requires custom conversion
131/// to/from a yaml scalar. For example:
132///
133/// template<>
134/// struct ScalarTraits<MyType> {
135/// static void output(const MyType &val, void*, llvm::raw_ostream &out) {
136/// // stream out custom formatting
137/// out << llvm::format("%x", val);
138/// }
139/// static StringRef input(StringRef scalar, void*, MyType &value) {
140/// // parse scalar and set `value`
141/// // return empty string on success, or error string
142/// return StringRef();
143/// }
144/// static QuotingType mustQuote(StringRef) { return QuotingType::Single; }
145/// };
146template <typename T, typename Enable = void> struct ScalarTraits {
147 // Must provide:
148 //
149 // Function to write the value as a string:
150 // static void output(const T &value, void *ctxt, llvm::raw_ostream &out);
151 //
152 // Function to convert a string to a value. Returns the empty
153 // StringRef on success or an error string if string is malformed:
154 // static StringRef input(StringRef scalar, void *ctxt, T &value);
155 //
156 // Function to determine if the value should be quoted.
157 // static QuotingType mustQuote(StringRef);
158};
159
160/// This class should be specialized by type that requires custom conversion
161/// to/from a YAML literal block scalar. For example:
162///
163/// template <>
164/// struct BlockScalarTraits<MyType> {
165/// static void output(const MyType &Value, void*, llvm::raw_ostream &Out)
166/// {
167/// // stream out custom formatting
168/// Out << Value;
169/// }
170/// static StringRef input(StringRef Scalar, void*, MyType &Value) {
171/// // parse scalar and set `value`
172/// // return empty string on success, or error string
173/// return StringRef();
174/// }
175/// };
176template <typename T>
177struct BlockScalarTraits {
178 // Must provide:
179 //
180 // Function to write the value as a string:
181 // static void output(const T &Value, void *ctx, llvm::raw_ostream &Out);
182 //
183 // Function to convert a string to a value. Returns the empty
184 // StringRef on success or an error string if string is malformed:
185 // static StringRef input(StringRef Scalar, void *ctxt, T &Value);
186 //
187 // Optional:
188 // static StringRef inputTag(T &Val, std::string Tag)
189 // static void outputTag(const T &Val, raw_ostream &Out)
190};
191
192/// This class should be specialized by type that requires custom conversion
193/// to/from a YAML scalar with optional tags. For example:
194///
195/// template <>
196/// struct TaggedScalarTraits<MyType> {
197/// static void output(const MyType &Value, void*, llvm::raw_ostream
198/// &ScalarOut, llvm::raw_ostream &TagOut)
199/// {
200/// // stream out custom formatting including optional Tag
201/// Out << Value;
202/// }
203/// static StringRef input(StringRef Scalar, StringRef Tag, void*, MyType
204/// &Value) {
205/// // parse scalar and set `value`
206/// // return empty string on success, or error string
207/// return StringRef();
208/// }
209/// static QuotingType mustQuote(const MyType &Value, StringRef) {
210/// return QuotingType::Single;
211/// }
212/// };
213template <typename T> struct TaggedScalarTraits {
214 // Must provide:
215 //
216 // Function to write the value and tag as strings:
217 // static void output(const T &Value, void *ctx, llvm::raw_ostream &ScalarOut,
218 // llvm::raw_ostream &TagOut);
219 //
220 // Function to convert a string to a value. Returns the empty
221 // StringRef on success or an error string if string is malformed:
222 // static StringRef input(StringRef Scalar, StringRef Tag, void *ctxt, T
223 // &Value);
224 //
225 // Function to determine if the value should be quoted.
226 // static QuotingType mustQuote(const T &Value, StringRef Scalar);
227};
228
229/// This class should be specialized by any type that needs to be converted
230/// to/from a YAML sequence. For example:
231///
232/// template<>
233/// struct SequenceTraits<MyContainer> {
234/// static size_t size(IO &io, MyContainer &seq) {
235/// return seq.size();
236/// }
237/// static MyType& element(IO &, MyContainer &seq, size_t index) {
238/// if ( index >= seq.size() )
239/// seq.resize(index+1);
240/// return seq[index];
241/// }
242/// };
243template<typename T, typename EnableIf = void>
244struct SequenceTraits {
245 // Must provide:
246 // static size_t size(IO &io, T &seq);
247 // static T::value_type& element(IO &io, T &seq, size_t index);
248 //
249 // The following is option and will cause generated YAML to use
250 // a flow sequence (e.g. [a,b,c]).
251 // static const bool flow = true;
252};
253
254/// This class should be specialized by any type for which vectors of that
255/// type need to be converted to/from a YAML sequence.
256template<typename T, typename EnableIf = void>
257struct SequenceElementTraits {
258 // Must provide:
259 // static const bool flow;
260};
261
262/// This class should be specialized by any type that needs to be converted
263/// to/from a list of YAML documents.
264template<typename T>
265struct DocumentListTraits {
266 // Must provide:
267 // static size_t size(IO &io, T &seq);
268 // static T::value_type& element(IO &io, T &seq, size_t index);
269};
270
271/// This class should be specialized by any type that needs to be converted
272/// to/from a YAML mapping in the case where the names of the keys are not known
273/// in advance, e.g. a string map.
274template <typename T>
275struct CustomMappingTraits {
276 // static void inputOne(IO &io, StringRef key, T &elem);
277 // static void output(IO &io, T &elem);
278};
279
280/// This class should be specialized by any type that can be represented as
281/// a scalar, map, or sequence, decided dynamically. For example:
282///
283/// typedef std::unique_ptr<MyBase> MyPoly;
284///
285/// template<>
286/// struct PolymorphicTraits<MyPoly> {
287/// static NodeKind getKind(const MyPoly &poly) {
288/// return poly->getKind();
289/// }
290/// static MyScalar& getAsScalar(MyPoly &poly) {
291/// if (!poly || !isa<MyScalar>(poly))
292/// poly.reset(new MyScalar());
293/// return *cast<MyScalar>(poly.get());
294/// }
295/// // ...
296/// };
297template <typename T> struct PolymorphicTraits {
298 // Must provide:
299 // static NodeKind getKind(const T &poly);
300 // static scalar_type &getAsScalar(T &poly);
301 // static map_type &getAsMap(T &poly);
302 // static sequence_type &getAsSequence(T &poly);
303};
304
305// Only used for better diagnostics of missing traits
306template <typename T>
307struct MissingTrait;
308
309// Test if ScalarEnumerationTraits<T> is defined on type T.
310template <class T>
311struct has_ScalarEnumerationTraits
312{
313 using Signature_enumeration = void (*)(class IO&, T&);
314
315 template <typename U>
316 static char test(SameType<Signature_enumeration, &U::enumeration>*);
317
318 template <typename U>
319 static double test(...);
320
321 static bool const value =
322 (sizeof(test<ScalarEnumerationTraits<T>>(nullptr)) == 1);
323};
324
325// Test if ScalarBitSetTraits<T> is defined on type T.
326template <class T>
327struct has_ScalarBitSetTraits
328{
329 using Signature_bitset = void (*)(class IO&, T&);
330
331 template <typename U>
332 static char test(SameType<Signature_bitset, &U::bitset>*);
333
334 template <typename U>
335 static double test(...);
336
337 static bool const value = (sizeof(test<ScalarBitSetTraits<T>>(nullptr)) == 1);
338};
339
340// Test if ScalarTraits<T> is defined on type T.
341template <class T>
342struct has_ScalarTraits
343{
344 using Signature_input = StringRef (*)(StringRef, void*, T&);
345 using Signature_output = void (*)(const T&, void*, raw_ostream&);
346 using Signature_mustQuote = QuotingType (*)(StringRef);
347
348 template <typename U>
349 static char test(SameType<Signature_input, &U::input> *,
350 SameType<Signature_output, &U::output> *,
351 SameType<Signature_mustQuote, &U::mustQuote> *);
352
353 template <typename U>
354 static double test(...);
355
356 static bool const value =
357 (sizeof(test<ScalarTraits<T>>(nullptr, nullptr, nullptr)) == 1);
358};
359
360// Test if BlockScalarTraits<T> is defined on type T.
361template <class T>
362struct has_BlockScalarTraits
363{
364 using Signature_input = StringRef (*)(StringRef, void *, T &);
365 using Signature_output = void (*)(const T &, void *, raw_ostream &);
366
367 template <typename U>
368 static char test(SameType<Signature_input, &U::input> *,
369 SameType<Signature_output, &U::output> *);
370
371 template <typename U>
372 static double test(...);
373
374 static bool const value =
375 (sizeof(test<BlockScalarTraits<T>>(nullptr, nullptr)) == 1);
376};
377
378// Test if TaggedScalarTraits<T> is defined on type T.
379template <class T> struct has_TaggedScalarTraits {
380 using Signature_input = StringRef (*)(StringRef, StringRef, void *, T &);
381 using Signature_output = void (*)(const T &, void *, raw_ostream &,
382 raw_ostream &);
383 using Signature_mustQuote = QuotingType (*)(const T &, StringRef);
384
385 template <typename U>
386 static char test(SameType<Signature_input, &U::input> *,
387 SameType<Signature_output, &U::output> *,
388 SameType<Signature_mustQuote, &U::mustQuote> *);
389
390 template <typename U> static double test(...);
391
392 static bool const value =
393 (sizeof(test<TaggedScalarTraits<T>>(nullptr, nullptr, nullptr)) == 1);
394};
395
396// Test if MappingContextTraits<T> is defined on type T.
397template <class T, class Context> struct has_MappingTraits {
398 using Signature_mapping = void (*)(class IO &, T &, Context &);
399
400 template <typename U>
401 static char test(SameType<Signature_mapping, &U::mapping>*);
402
403 template <typename U>
404 static double test(...);
405
406 static bool const value =
407 (sizeof(test<MappingContextTraits<T, Context>>(nullptr)) == 1);
408};
409
410// Test if MappingTraits<T> is defined on type T.
411template <class T> struct has_MappingTraits<T, EmptyContext> {
412 using Signature_mapping = void (*)(class IO &, T &);
413
414 template <typename U>
415 static char test(SameType<Signature_mapping, &U::mapping> *);
416
417 template <typename U> static double test(...);
418
419 static bool const value = (sizeof(test<MappingTraits<T>>(nullptr)) == 1);
420};
421
422// Test if MappingContextTraits<T>::validate() is defined on type T.
423template <class T, class Context> struct has_MappingValidateTraits {
424 using Signature_validate = StringRef (*)(class IO &, T &, Context &);
425
426 template <typename U>
427 static char test(SameType<Signature_validate, &U::validate>*);
428
429 template <typename U>
430 static double test(...);
431
432 static bool const value =
433 (sizeof(test<MappingContextTraits<T, Context>>(nullptr)) == 1);
434};
435
436// Test if MappingTraits<T>::validate() is defined on type T.
437template <class T> struct has_MappingValidateTraits<T, EmptyContext> {
438 using Signature_validate = StringRef (*)(class IO &, T &);
439
440 template <typename U>
441 static char test(SameType<Signature_validate, &U::validate> *);
442
443 template <typename U> static double test(...);
444
445 static bool const value = (sizeof(test<MappingTraits<T>>(nullptr)) == 1);
446};
447
448// Test if SequenceTraits<T> is defined on type T.
449template <class T>
450struct has_SequenceMethodTraits
451{
452 using Signature_size = size_t (*)(class IO&, T&);
453
454 template <typename U>
455 static char test(SameType<Signature_size, &U::size>*);
456
457 template <typename U>
458 static double test(...);
459
460 static bool const value = (sizeof(test<SequenceTraits<T>>(nullptr)) == 1);
461};
462
463// Test if CustomMappingTraits<T> is defined on type T.
464template <class T>
465struct has_CustomMappingTraits
466{
467 using Signature_input = void (*)(IO &io, StringRef key, T &v);
468
469 template <typename U>
470 static char test(SameType<Signature_input, &U::inputOne>*);
471
472 template <typename U>
473 static double test(...);
474
475 static bool const value =
476 (sizeof(test<CustomMappingTraits<T>>(nullptr)) == 1);
477};
478
479// has_FlowTraits<int> will cause an error with some compilers because
480// it subclasses int. Using this wrapper only instantiates the
481// real has_FlowTraits only if the template type is a class.
482template <typename T, bool Enabled = std::is_class<T>::value>
483class has_FlowTraits
484{
485public:
486 static const bool value = false;
487};
488
489// Some older gcc compilers don't support straight forward tests
490// for members, so test for ambiguity cause by the base and derived
491// classes both defining the member.
492template <class T>
493struct has_FlowTraits<T, true>
494{
495 struct Fallback { bool flow; };
496 struct Derived : T, Fallback { };
497
498 template<typename C>
499 static char (&f(SameType<bool Fallback::*, &C::flow>*))[1];
500
501 template<typename C>
502 static char (&f(...))[2];
503
504 static bool const value = sizeof(f<Derived>(nullptr)) == 2;
505};
506
507// Test if SequenceTraits<T> is defined on type T
508template<typename T>
509struct has_SequenceTraits : public std::integral_constant<bool,
510 has_SequenceMethodTraits<T>::value > { };
511
512// Test if DocumentListTraits<T> is defined on type T
513template <class T>
514struct has_DocumentListTraits
515{
516 using Signature_size = size_t (*)(class IO &, T &);
517
518 template <typename U>
519 static char test(SameType<Signature_size, &U::size>*);
520
521 template <typename U>
522 static double test(...);
523
524 static bool const value = (sizeof(test<DocumentListTraits<T>>(nullptr))==1);
525};
526
527template <class T> struct has_PolymorphicTraits {
528 using Signature_getKind = NodeKind (*)(const T &);
529
530 template <typename U>
531 static char test(SameType<Signature_getKind, &U::getKind> *);
532
533 template <typename U> static double test(...);
534
535 static bool const value = (sizeof(test<PolymorphicTraits<T>>(nullptr)) == 1);
536};
537
538inline bool isNumeric(StringRef S) {
539 const static auto skipDigits = [](StringRef Input) {
540 return Input.drop_front(
541 std::min(Input.find_first_not_of("0123456789"), Input.size()));
542 };
543
544 // Make S.front() and S.drop_front().front() (if S.front() is [+-]) calls
545 // safe.
546 if (S.empty() || S.equals("+") || S.equals("-"))
547 return false;
548
549 if (S.equals(".nan") || S.equals(".NaN") || S.equals(".NAN"))
550 return true;
551
552 // Infinity and decimal numbers can be prefixed with sign.
553 StringRef Tail = (S.front() == '-' || S.front() == '+') ? S.drop_front() : S;
554
555 // Check for infinity first, because checking for hex and oct numbers is more
556 // expensive.
557 if (Tail.equals(".inf") || Tail.equals(".Inf") || Tail.equals(".INF"))
558 return true;
559
560 // Section 10.3.2 Tag Resolution
561 // YAML 1.2 Specification prohibits Base 8 and Base 16 numbers prefixed with
562 // [-+], so S should be used instead of Tail.
563 if (S.startswith("0o"))
564 return S.size() > 2 &&
565 S.drop_front(2).find_first_not_of("01234567") == StringRef::npos;
566
567 if (S.startswith("0x"))
568 return S.size() > 2 && S.drop_front(2).find_first_not_of(
569 "0123456789abcdefABCDEF") == StringRef::npos;
570
571 // Parse float: [-+]? (\. [0-9]+ | [0-9]+ (\. [0-9]* )?) ([eE] [-+]? [0-9]+)?
572 S = Tail;
573
574 // Handle cases when the number starts with '.' and hence needs at least one
575 // digit after dot (as opposed by number which has digits before the dot), but
576 // doesn't have one.
577 if (S.startswith(".") &&
578 (S.equals(".") ||
579 (S.size() > 1 && std::strchr("0123456789", S[1]) == nullptr)))
580 return false;
581
582 if (S.startswith("E") || S.startswith("e"))
583 return false;
584
585 enum ParseState {
586 Default,
587 FoundDot,
588 FoundExponent,
589 };
590 ParseState State = Default;
591
592 S = skipDigits(S);
593
594 // Accept decimal integer.
595 if (S.empty())
596 return true;
597
598 if (S.front() == '.') {
599 State = FoundDot;
600 S = S.drop_front();
601 } else if (S.front() == 'e' || S.front() == 'E') {
602 State = FoundExponent;
603 S = S.drop_front();
604 } else {
605 return false;
606 }
607
608 if (State == FoundDot) {
609 S = skipDigits(S);
610 if (S.empty())
611 return true;
612
613 if (S.front() == 'e' || S.front() == 'E') {
614 State = FoundExponent;
615 S = S.drop_front();
616 } else {
617 return false;
618 }
619 }
620
621 assert(State == FoundExponent && "Should have found exponent at this point.")((State == FoundExponent && "Should have found exponent at this point."
) ? static_cast<void> (0) : __assert_fail ("State == FoundExponent && \"Should have found exponent at this point.\""
, "/build/llvm-toolchain-snapshot-10~svn374814/include/llvm/Support/YAMLTraits.h"
, 621, __PRETTY_FUNCTION__))
;
622 if (S.empty())
623 return false;
624
625 if (S.front() == '+' || S.front() == '-') {
626 S = S.drop_front();
627 if (S.empty())
628 return false;
629 }
630
631 return skipDigits(S).empty();
632}
633
634inline bool isNull(StringRef S) {
635 return S.equals("null") || S.equals("Null") || S.equals("NULL") ||
636 S.equals("~");
637}
638
639inline bool isBool(StringRef S) {
640 return S.equals("true") || S.equals("True") || S.equals("TRUE") ||
641 S.equals("false") || S.equals("False") || S.equals("FALSE");
642}
643
644// 5.1. Character Set
645// The allowed character range explicitly excludes the C0 control block #x0-#x1F
646// (except for TAB #x9, LF #xA, and CR #xD which are allowed), DEL #x7F, the C1
647// control block #x80-#x9F (except for NEL #x85 which is allowed), the surrogate
648// block #xD800-#xDFFF, #xFFFE, and #xFFFF.
649inline QuotingType needsQuotes(StringRef S) {
650 if (S.empty())
651 return QuotingType::Single;
652 if (isspace(S.front()) || isspace(S.back()))
653 return QuotingType::Single;
654 if (isNull(S))
655 return QuotingType::Single;
656 if (isBool(S))
657 return QuotingType::Single;
658 if (isNumeric(S))
659 return QuotingType::Single;
660
661 // 7.3.3 Plain Style
662 // Plain scalars must not begin with most indicators, as this would cause
663 // ambiguity with other YAML constructs.
664 static constexpr char Indicators[] = R"(-?:\,[]{}#&*!|>'"%@`)";
665 if (S.find_first_of(Indicators) == 0)
666 return QuotingType::Single;
667
668 QuotingType MaxQuotingNeeded = QuotingType::None;
669 for (unsigned char C : S) {
670 // Alphanum is safe.
671 if (isAlnum(C))
672 continue;
673
674 switch (C) {
675 // Safe scalar characters.
676 case '_':
677 case '-':
678 case '^':
679 case '.':
680 case ',':
681 case ' ':
682 // TAB (0x9) is allowed in unquoted strings.
683 case 0x9:
684 continue;
685 // LF(0xA) and CR(0xD) may delimit values and so require at least single
686 // quotes.
687 case 0xA:
688 case 0xD:
689 MaxQuotingNeeded = QuotingType::Single;
690 continue;
691 // DEL (0x7F) are excluded from the allowed character range.
692 case 0x7F:
693 return QuotingType::Double;
694 // Forward slash is allowed to be unquoted, but we quote it anyway. We have
695 // many tests that use FileCheck against YAML output, and this output often
696 // contains paths. If we quote backslashes but not forward slashes then
697 // paths will come out either quoted or unquoted depending on which platform
698 // the test is run on, making FileCheck comparisons difficult.
699 case '/':
700 default: {
701 // C0 control block (0x0 - 0x1F) is excluded from the allowed character
702 // range.
703 if (C <= 0x1F)
704 return QuotingType::Double;
705
706 // Always double quote UTF-8.
707 if ((C & 0x80) != 0)
708 return QuotingType::Double;
709
710 // The character is not safe, at least simple quoting needed.
711 MaxQuotingNeeded = QuotingType::Single;
712 }
713 }
714 }
715
716 return MaxQuotingNeeded;
717}
718
719template <typename T, typename Context>
720struct missingTraits
721 : public std::integral_constant<bool,
722 !has_ScalarEnumerationTraits<T>::value &&
723 !has_ScalarBitSetTraits<T>::value &&
724 !has_ScalarTraits<T>::value &&
725 !has_BlockScalarTraits<T>::value &&
726 !has_TaggedScalarTraits<T>::value &&
727 !has_MappingTraits<T, Context>::value &&
728 !has_SequenceTraits<T>::value &&
729 !has_CustomMappingTraits<T>::value &&
730 !has_DocumentListTraits<T>::value &&
731 !has_PolymorphicTraits<T>::value> {};
732
733template <typename T, typename Context>
734struct validatedMappingTraits
735 : public std::integral_constant<
736 bool, has_MappingTraits<T, Context>::value &&
737 has_MappingValidateTraits<T, Context>::value> {};
738
739template <typename T, typename Context>
740struct unvalidatedMappingTraits
741 : public std::integral_constant<
742 bool, has_MappingTraits<T, Context>::value &&
743 !has_MappingValidateTraits<T, Context>::value> {};
744
745// Base class for Input and Output.
746class IO {
747public:
748 IO(void *Ctxt = nullptr);
749 virtual ~IO();
750
751 virtual bool outputting() const = 0;
752
753 virtual unsigned beginSequence() = 0;
754 virtual bool preflightElement(unsigned, void *&) = 0;
755 virtual void postflightElement(void*) = 0;
756 virtual void endSequence() = 0;
757 virtual bool canElideEmptySequence() = 0;
758
759 virtual unsigned beginFlowSequence() = 0;
760 virtual bool preflightFlowElement(unsigned, void *&) = 0;
761 virtual void postflightFlowElement(void*) = 0;
762 virtual void endFlowSequence() = 0;
763
764 virtual bool mapTag(StringRef Tag, bool Default=false) = 0;
765 virtual void beginMapping() = 0;
766 virtual void endMapping() = 0;
767 virtual bool preflightKey(const char*, bool, bool, bool &, void *&) = 0;
768 virtual void postflightKey(void*) = 0;
769 virtual std::vector<StringRef> keys() = 0;
770
771 virtual void beginFlowMapping() = 0;
772 virtual void endFlowMapping() = 0;
773
774 virtual void beginEnumScalar() = 0;
775 virtual bool matchEnumScalar(const char*, bool) = 0;
776 virtual bool matchEnumFallback() = 0;
777 virtual void endEnumScalar() = 0;
778
779 virtual bool beginBitSetScalar(bool &) = 0;
780 virtual bool bitSetMatch(const char*, bool) = 0;
781 virtual void endBitSetScalar() = 0;
782
783 virtual void scalarString(StringRef &, QuotingType) = 0;
784 virtual void blockScalarString(StringRef &) = 0;
785 virtual void scalarTag(std::string &) = 0;
786
787 virtual NodeKind getNodeKind() = 0;
788
789 virtual void setError(const Twine &) = 0;
790
791 template <typename T>
792 void enumCase(T &Val, const char* Str, const T ConstVal) {
793 if ( matchEnumScalar(Str, outputting() && Val == ConstVal) ) {
794 Val = ConstVal;
795 }
796 }
797
798 // allow anonymous enum values to be used with LLVM_YAML_STRONG_TYPEDEF
799 template <typename T>
800 void enumCase(T &Val, const char* Str, const uint32_t ConstVal) {
801 if ( matchEnumScalar(Str, outputting() && Val == static_cast<T>(ConstVal)) ) {
802 Val = ConstVal;
803 }
804 }
805
806 template <typename FBT, typename T>
807 void enumFallback(T &Val) {
808 if (matchEnumFallback()) {
809 EmptyContext Context;
810 // FIXME: Force integral conversion to allow strong typedefs to convert.
811 FBT Res = static_cast<typename FBT::BaseType>(Val);
812 yamlize(*this, Res, true, Context);
813 Val = static_cast<T>(static_cast<typename FBT::BaseType>(Res));
814 }
815 }
816
817 template <typename T>
818 void bitSetCase(T &Val, const char* Str, const T ConstVal) {
819 if ( bitSetMatch(Str, outputting() && (Val & ConstVal) == ConstVal) ) {
820 Val = static_cast<T>(Val | ConstVal);
821 }
822 }
823
824 // allow anonymous enum values to be used with LLVM_YAML_STRONG_TYPEDEF
825 template <typename T>
826 void bitSetCase(T &Val, const char* Str, const uint32_t ConstVal) {
827 if ( bitSetMatch(Str, outputting() && (Val & ConstVal) == ConstVal) ) {
828 Val = static_cast<T>(Val | ConstVal);
829 }
830 }
831
832 template <typename T>
833 void maskedBitSetCase(T &Val, const char *Str, T ConstVal, T Mask) {
834 if (bitSetMatch(Str, outputting() && (Val & Mask) == ConstVal))
835 Val = Val | ConstVal;
836 }
837
838 template <typename T>
839 void maskedBitSetCase(T &Val, const char *Str, uint32_t ConstVal,
840 uint32_t Mask) {
841 if (bitSetMatch(Str, outputting() && (Val & Mask) == ConstVal))
842 Val = Val | ConstVal;
843 }
844
845 void *getContext() const;
846 void setContext(void *);
847
848 template <typename T> void mapRequired(const char *Key, T &Val) {
849 EmptyContext Ctx;
850 this->processKey(Key, Val, true, Ctx);
2
Calling 'IO::processKey'
23
Calling 'IO::processKey'
27
Returning from 'IO::processKey'
851 }
28
Returning without writing to 'Val'
852
853 template <typename T, typename Context>
854 void mapRequired(const char *Key, T &Val, Context &Ctx) {
855 this->processKey(Key, Val, true, Ctx);
856 }
857
858 template <typename T> void mapOptional(const char *Key, T &Val) {
859 EmptyContext Ctx;
860 mapOptionalWithContext(Key, Val, Ctx);
861 }
862
863 template <typename T, typename DefaultT>
864 void mapOptional(const char *Key, T &Val, const DefaultT &Default) {
865 EmptyContext Ctx;
866 mapOptionalWithContext(Key, Val, Default, Ctx);
867 }
868
869 template <typename T, typename Context>
870 typename std::enable_if<has_SequenceTraits<T>::value, void>::type
871 mapOptionalWithContext(const char *Key, T &Val, Context &Ctx) {
872 // omit key/value instead of outputting empty sequence
873 if (this->canElideEmptySequence() && !(Val.begin() != Val.end()))
874 return;
875 this->processKey(Key, Val, false, Ctx);
876 }
877
878 template <typename T, typename Context>
879 void mapOptionalWithContext(const char *Key, Optional<T> &Val, Context &Ctx) {
880 this->processKeyWithDefault(Key, Val, Optional<T>(), /*Required=*/false,
881 Ctx);
882 }
883
884 template <typename T, typename Context>
885 typename std::enable_if<!has_SequenceTraits<T>::value, void>::type
886 mapOptionalWithContext(const char *Key, T &Val, Context &Ctx) {
887 this->processKey(Key, Val, false, Ctx);
888 }
889
890 template <typename T, typename Context, typename DefaultT>
891 void mapOptionalWithContext(const char *Key, T &Val, const DefaultT &Default,
892 Context &Ctx) {
893 static_assert(std::is_convertible<DefaultT, T>::value,
894 "Default type must be implicitly convertible to value type!");
895 this->processKeyWithDefault(Key, Val, static_cast<const T &>(Default),
896 false, Ctx);
897 }
898
899private:
900 template <typename T, typename Context>
901 void processKeyWithDefault(const char *Key, Optional<T> &Val,
902 const Optional<T> &DefaultValue, bool Required,
903 Context &Ctx) {
904 assert(DefaultValue.hasValue() == false &&((DefaultValue.hasValue() == false && "Optional<T> shouldn't have a value!"
) ? static_cast<void> (0) : __assert_fail ("DefaultValue.hasValue() == false && \"Optional<T> shouldn't have a value!\""
, "/build/llvm-toolchain-snapshot-10~svn374814/include/llvm/Support/YAMLTraits.h"
, 905, __PRETTY_FUNCTION__))
905 "Optional<T> shouldn't have a value!")((DefaultValue.hasValue() == false && "Optional<T> shouldn't have a value!"
) ? static_cast<void> (0) : __assert_fail ("DefaultValue.hasValue() == false && \"Optional<T> shouldn't have a value!\""
, "/build/llvm-toolchain-snapshot-10~svn374814/include/llvm/Support/YAMLTraits.h"
, 905, __PRETTY_FUNCTION__))
;
906 void *SaveInfo;
907 bool UseDefault = true;
908 const bool sameAsDefault = outputting() && !Val.hasValue();
909 if (!outputting() && !Val.hasValue())
910 Val = T();
911 if (Val.hasValue() &&
912 this->preflightKey(Key, Required, sameAsDefault, UseDefault,
913 SaveInfo)) {
914 yamlize(*this, Val.getValue(), Required, Ctx);
915 this->postflightKey(SaveInfo);
916 } else {
917 if (UseDefault)
918 Val = DefaultValue;
919 }
920 }
921
922 template <typename T, typename Context>
923 void processKeyWithDefault(const char *Key, T &Val, const T &DefaultValue,
924 bool Required, Context &Ctx) {
925 void *SaveInfo;
926 bool UseDefault;
927 const bool sameAsDefault = outputting() && Val == DefaultValue;
928 if ( this->preflightKey(Key, Required, sameAsDefault, UseDefault,
929 SaveInfo) ) {
930 yamlize(*this, Val, Required, Ctx);
931 this->postflightKey(SaveInfo);
932 }
933 else {
934 if ( UseDefault )
935 Val = DefaultValue;
936 }
937 }
938
939 template <typename T, typename Context>
940 void processKey(const char *Key, T &Val, bool Required, Context &Ctx) {
941 void *SaveInfo;
942 bool UseDefault;
943 if ( this->preflightKey(Key, Required, false, UseDefault, SaveInfo) ) {
3
Assuming the condition is true
4
Taking true branch
24
Assuming the condition is false
25
Taking false branch
944 yamlize(*this, Val, Required, Ctx);
5
Calling 'yamlize<std::vector<std::unique_ptr<llvm::MinidumpYAML::Stream, std::default_delete<llvm::MinidumpYAML::Stream> >, std::allocator<std::unique_ptr<llvm::MinidumpYAML::Stream, std::default_delete<llvm::MinidumpYAML::Stream> > > >, llvm::yaml::EmptyContext>'
945 this->postflightKey(SaveInfo);
946 }
947 }
26
Returning without writing to 'Val'
948
949private:
950 void *Ctxt;
951};
952
953namespace detail {
954
955template <typename T, typename Context>
956void doMapping(IO &io, T &Val, Context &Ctx) {
957 MappingContextTraits<T, Context>::mapping(io, Val, Ctx);
958}
959
960template <typename T> void doMapping(IO &io, T &Val, EmptyContext &Ctx) {
961 MappingTraits<T>::mapping(io, Val);
18
Calling 'MappingTraits::mapping'
962}
963
964} // end namespace detail
965
966template <typename T>
967typename std::enable_if<has_ScalarEnumerationTraits<T>::value, void>::type
968yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
969 io.beginEnumScalar();
970 ScalarEnumerationTraits<T>::enumeration(io, Val);
971 io.endEnumScalar();
972}
973
974template <typename T>
975typename std::enable_if<has_ScalarBitSetTraits<T>::value, void>::type
976yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
977 bool DoClear;
978 if ( io.beginBitSetScalar(DoClear) ) {
979 if ( DoClear )
980 Val = T();
981 ScalarBitSetTraits<T>::bitset(io, Val);
982 io.endBitSetScalar();
983 }
984}
985
986template <typename T>
987typename std::enable_if<has_ScalarTraits<T>::value, void>::type
988yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
989 if ( io.outputting() ) {
990 std::string Storage;
991 raw_string_ostream Buffer(Storage);
992 ScalarTraits<T>::output(Val, io.getContext(), Buffer);
993 StringRef Str = Buffer.str();
994 io.scalarString(Str, ScalarTraits<T>::mustQuote(Str));
995 }
996 else {
997 StringRef Str;
998 io.scalarString(Str, ScalarTraits<T>::mustQuote(Str));
999 StringRef Result = ScalarTraits<T>::input(Str, io.getContext(), Val);
1000 if ( !Result.empty() ) {
1001 io.setError(Twine(Result));
1002 }
1003 }
1004}
1005
1006template <typename T>
1007typename std::enable_if<has_BlockScalarTraits<T>::value, void>::type
1008yamlize(IO &YamlIO, T &Val, bool, EmptyContext &Ctx) {
1009 if (YamlIO.outputting()) {
1010 std::string Storage;
1011 raw_string_ostream Buffer(Storage);
1012 BlockScalarTraits<T>::output(Val, YamlIO.getContext(), Buffer);
1013 StringRef Str = Buffer.str();
1014 YamlIO.blockScalarString(Str);
1015 } else {
1016 StringRef Str;
1017 YamlIO.blockScalarString(Str);
1018 StringRef Result =
1019 BlockScalarTraits<T>::input(Str, YamlIO.getContext(), Val);
1020 if (!Result.empty())
1021 YamlIO.setError(Twine(Result));
1022 }
1023}
1024
1025template <typename T>
1026typename std::enable_if<has_TaggedScalarTraits<T>::value, void>::type
1027yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
1028 if (io.outputting()) {
1029 std::string ScalarStorage, TagStorage;
1030 raw_string_ostream ScalarBuffer(ScalarStorage), TagBuffer(TagStorage);
1031 TaggedScalarTraits<T>::output(Val, io.getContext(), ScalarBuffer,
1032 TagBuffer);
1033 io.scalarTag(TagBuffer.str());
1034 StringRef ScalarStr = ScalarBuffer.str();
1035 io.scalarString(ScalarStr,
1036 TaggedScalarTraits<T>::mustQuote(Val, ScalarStr));
1037 } else {
1038 std::string Tag;
1039 io.scalarTag(Tag);
1040 StringRef Str;
1041 io.scalarString(Str, QuotingType::None);
1042 StringRef Result =
1043 TaggedScalarTraits<T>::input(Str, Tag, io.getContext(), Val);
1044 if (!Result.empty()) {
1045 io.setError(Twine(Result));
1046 }
1047 }
1048}
1049
1050template <typename T, typename Context>
1051typename std::enable_if<validatedMappingTraits<T, Context>::value, void>::type
1052yamlize(IO &io, T &Val, bool, Context &Ctx) {
1053 if (has_FlowTraits<MappingTraits<T>>::value
13.1
'value' is false
13.1
'value' is false
)
14
Taking false branch
1054 io.beginFlowMapping();
1055 else
1056 io.beginMapping();
1057 if (io.outputting()) {
15
Assuming the condition is false
16
Taking false branch
1058 StringRef Err = MappingTraits<T>::validate(io, Val);
1059 if (!Err.empty()) {
1060 errs() << Err << "\n";
1061 assert(Err.empty() && "invalid struct trying to be written as yaml")((Err.empty() && "invalid struct trying to be written as yaml"
) ? static_cast<void> (0) : __assert_fail ("Err.empty() && \"invalid struct trying to be written as yaml\""
, "/build/llvm-toolchain-snapshot-10~svn374814/include/llvm/Support/YAMLTraits.h"
, 1061, __PRETTY_FUNCTION__))
;
1062 }
1063 }
1064 detail::doMapping(io, Val, Ctx);
17
Calling 'doMapping<std::unique_ptr<llvm::MinidumpYAML::Stream, std::default_delete<llvm::MinidumpYAML::Stream> >>'
1065 if (!io.outputting()) {
1066 StringRef Err = MappingTraits<T>::validate(io, Val);
1067 if (!Err.empty())
1068 io.setError(Err);
1069 }
1070 if (has_FlowTraits<MappingTraits<T>>::value)
1071 io.endFlowMapping();
1072 else
1073 io.endMapping();
1074}
1075
1076template <typename T, typename Context>
1077typename std::enable_if<unvalidatedMappingTraits<T, Context>::value, void>::type
1078yamlize(IO &io, T &Val, bool, Context &Ctx) {
1079 if (has_FlowTraits<MappingTraits<T>>::value) {
1080 io.beginFlowMapping();
1081 detail::doMapping(io, Val, Ctx);
1082 io.endFlowMapping();
1083 } else {
1084 io.beginMapping();
1085 detail::doMapping(io, Val, Ctx);
1086 io.endMapping();
1087 }
1088}
1089
1090template <typename T>
1091typename std::enable_if<has_CustomMappingTraits<T>::value, void>::type
1092yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
1093 if ( io.outputting() ) {
1094 io.beginMapping();
1095 CustomMappingTraits<T>::output(io, Val);
1096 io.endMapping();
1097 } else {
1098 io.beginMapping();
1099 for (StringRef key : io.keys())
1100 CustomMappingTraits<T>::inputOne(io, key, Val);
1101 io.endMapping();
1102 }
1103}
1104
1105template <typename T>
1106typename std::enable_if<has_PolymorphicTraits<T>::value, void>::type
1107yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
1108 switch (io.outputting() ? PolymorphicTraits<T>::getKind(Val)
1109 : io.getNodeKind()) {
1110 case NodeKind::Scalar:
1111 return yamlize(io, PolymorphicTraits<T>::getAsScalar(Val), true, Ctx);
1112 case NodeKind::Map:
1113 return yamlize(io, PolymorphicTraits<T>::getAsMap(Val), true, Ctx);
1114 case NodeKind::Sequence:
1115 return yamlize(io, PolymorphicTraits<T>::getAsSequence(Val), true, Ctx);
1116 }
1117}
1118
1119template <typename T>
1120typename std::enable_if<missingTraits<T, EmptyContext>::value, void>::type
1121yamlize(IO &io, T &Val, bool, EmptyContext &Ctx) {
1122 char missing_yaml_trait_for_type[sizeof(MissingTrait<T>)];
1123}
1124
1125template <typename T, typename Context>
1126typename std::enable_if<has_SequenceTraits<T>::value, void>::type
1127yamlize(IO &io, T &Seq, bool, Context &Ctx) {
1128 if ( has_FlowTraits< SequenceTraits<T>>::value
5.1
'value' is false
5.1
'value' is false
) {
6
Taking false branch
1129 unsigned incnt = io.beginFlowSequence();
1130 unsigned count = io.outputting() ? SequenceTraits<T>::size(io, Seq) : incnt;
1131 for(unsigned i=0; i < count; ++i) {
1132 void *SaveInfo;
1133 if ( io.preflightFlowElement(i, SaveInfo) ) {
1134 yamlize(io, SequenceTraits<T>::element(io, Seq, i), true, Ctx);
1135 io.postflightFlowElement(SaveInfo);
1136 }
1137 }
1138 io.endFlowSequence();
1139 }
1140 else {
1141 unsigned incnt = io.beginSequence();
1142 unsigned count = io.outputting() ? SequenceTraits<T>::size(io, Seq) : incnt;
7
Assuming the condition is false
8
'?' condition is false
1143 for(unsigned i=0; i < count; ++i) {
9
Assuming 'i' is < 'count'
10
Loop condition is true. Entering loop body
1144 void *SaveInfo;
1145 if ( io.preflightElement(i, SaveInfo) ) {
11
Assuming the condition is true
12
Taking true branch
1146 yamlize(io, SequenceTraits<T>::element(io, Seq, i), true, Ctx);
13
Calling 'yamlize<std::unique_ptr<llvm::MinidumpYAML::Stream, std::default_delete<llvm::MinidumpYAML::Stream> >, llvm::yaml::EmptyContext>'
1147 io.postflightElement(SaveInfo);
1148 }
1149 }
1150 io.endSequence();
1151 }
1152}
1153
1154template<>
1155struct ScalarTraits<bool> {
1156 static void output(const bool &, void* , raw_ostream &);
1157 static StringRef input(StringRef, void *, bool &);
1158 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1159};
1160
1161template<>
1162struct ScalarTraits<StringRef> {
1163 static void output(const StringRef &, void *, raw_ostream &);
1164 static StringRef input(StringRef, void *, StringRef &);
1165 static QuotingType mustQuote(StringRef S) { return needsQuotes(S); }
1166};
1167
1168template<>
1169struct ScalarTraits<std::string> {
1170 static void output(const std::string &, void *, raw_ostream &);
1171 static StringRef input(StringRef, void *, std::string &);
1172 static QuotingType mustQuote(StringRef S) { return needsQuotes(S); }
1173};
1174
1175template<>
1176struct ScalarTraits<uint8_t> {
1177 static void output(const uint8_t &, void *, raw_ostream &);
1178 static StringRef input(StringRef, void *, uint8_t &);
1179 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1180};
1181
1182template<>
1183struct ScalarTraits<uint16_t> {
1184 static void output(const uint16_t &, void *, raw_ostream &);
1185 static StringRef input(StringRef, void *, uint16_t &);
1186 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1187};
1188
1189template<>
1190struct ScalarTraits<uint32_t> {
1191 static void output(const uint32_t &, void *, raw_ostream &);
1192 static StringRef input(StringRef, void *, uint32_t &);
1193 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1194};
1195
1196template<>
1197struct ScalarTraits<uint64_t> {
1198 static void output(const uint64_t &, void *, raw_ostream &);
1199 static StringRef input(StringRef, void *, uint64_t &);
1200 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1201};
1202
1203template<>
1204struct ScalarTraits<int8_t> {
1205 static void output(const int8_t &, void *, raw_ostream &);
1206 static StringRef input(StringRef, void *, int8_t &);
1207 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1208};
1209
1210template<>
1211struct ScalarTraits<int16_t> {
1212 static void output(const int16_t &, void *, raw_ostream &);
1213 static StringRef input(StringRef, void *, int16_t &);
1214 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1215};
1216
1217template<>
1218struct ScalarTraits<int32_t> {
1219 static void output(const int32_t &, void *, raw_ostream &);
1220 static StringRef input(StringRef, void *, int32_t &);
1221 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1222};
1223
1224template<>
1225struct ScalarTraits<int64_t> {
1226 static void output(const int64_t &, void *, raw_ostream &);
1227 static StringRef input(StringRef, void *, int64_t &);
1228 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1229};
1230
1231template<>
1232struct ScalarTraits<float> {
1233 static void output(const float &, void *, raw_ostream &);
1234 static StringRef input(StringRef, void *, float &);
1235 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1236};
1237
1238template<>
1239struct ScalarTraits<double> {
1240 static void output(const double &, void *, raw_ostream &);
1241 static StringRef input(StringRef, void *, double &);
1242 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1243};
1244
1245// For endian types, we use existing scalar Traits class for the underlying
1246// type. This way endian aware types are supported whenever the traits are
1247// defined for the underlying type.
1248template <typename value_type, support::endianness endian, size_t alignment>
1249struct ScalarTraits<
1250 support::detail::packed_endian_specific_integral<value_type, endian,
1251 alignment>,
1252 typename std::enable_if<has_ScalarTraits<value_type>::value>::type> {
1253 using endian_type =
1254 support::detail::packed_endian_specific_integral<value_type, endian,
1255 alignment>;
1256
1257 static void output(const endian_type &E, void *Ctx, raw_ostream &Stream) {
1258 ScalarTraits<value_type>::output(static_cast<value_type>(E), Ctx, Stream);
1259 }
1260
1261 static StringRef input(StringRef Str, void *Ctx, endian_type &E) {
1262 value_type V;
1263 auto R = ScalarTraits<value_type>::input(Str, Ctx, V);
1264 E = static_cast<endian_type>(V);
1265 return R;
1266 }
1267
1268 static QuotingType mustQuote(StringRef Str) {
1269 return ScalarTraits<value_type>::mustQuote(Str);
1270 }
1271};
1272
1273template <typename value_type, support::endianness endian, size_t alignment>
1274struct ScalarEnumerationTraits<
1275 support::detail::packed_endian_specific_integral<value_type, endian,
1276 alignment>,
1277 typename std::enable_if<
1278 has_ScalarEnumerationTraits<value_type>::value>::type> {
1279 using endian_type =
1280 support::detail::packed_endian_specific_integral<value_type, endian,
1281 alignment>;
1282
1283 static void enumeration(IO &io, endian_type &E) {
1284 value_type V = E;
1285 ScalarEnumerationTraits<value_type>::enumeration(io, V);
1286 E = V;
1287 }
1288};
1289
1290template <typename value_type, support::endianness endian, size_t alignment>
1291struct ScalarBitSetTraits<
1292 support::detail::packed_endian_specific_integral<value_type, endian,
1293 alignment>,
1294 typename std::enable_if<has_ScalarBitSetTraits<value_type>::value>::type> {
1295 using endian_type =
1296 support::detail::packed_endian_specific_integral<value_type, endian,
1297 alignment>;
1298 static void bitset(IO &io, endian_type &E) {
1299 value_type V = E;
1300 ScalarBitSetTraits<value_type>::bitset(io, V);
1301 E = V;
1302 }
1303};
1304
1305// Utility for use within MappingTraits<>::mapping() method
1306// to [de]normalize an object for use with YAML conversion.
1307template <typename TNorm, typename TFinal>
1308struct MappingNormalization {
1309 MappingNormalization(IO &i_o, TFinal &Obj)
1310 : io(i_o), BufPtr(nullptr), Result(Obj) {
1311 if ( io.outputting() ) {
1312 BufPtr = new (&Buffer) TNorm(io, Obj);
1313 }
1314 else {
1315 BufPtr = new (&Buffer) TNorm(io);
1316 }
1317 }
1318
1319 ~MappingNormalization() {
1320 if ( ! io.outputting() ) {
1321 Result = BufPtr->denormalize(io);
1322 }
1323 BufPtr->~TNorm();
1324 }
1325
1326 TNorm* operator->() { return BufPtr; }
1327
1328private:
1329 using Storage = AlignedCharArrayUnion<TNorm>;
1330
1331 Storage Buffer;
1332 IO &io;
1333 TNorm *BufPtr;
1334 TFinal &Result;
1335};
1336
1337// Utility for use within MappingTraits<>::mapping() method
1338// to [de]normalize an object for use with YAML conversion.
1339template <typename TNorm, typename TFinal>
1340struct MappingNormalizationHeap {
1341 MappingNormalizationHeap(IO &i_o, TFinal &Obj, BumpPtrAllocator *allocator)
1342 : io(i_o), Result(Obj) {
1343 if ( io.outputting() ) {
1344 BufPtr = new (&Buffer) TNorm(io, Obj);
1345 }
1346 else if (allocator) {
1347 BufPtr = allocator->Allocate<TNorm>();
1348 new (BufPtr) TNorm(io);
1349 } else {
1350 BufPtr = new TNorm(io);
1351 }
1352 }
1353
1354 ~MappingNormalizationHeap() {
1355 if ( io.outputting() ) {
1356 BufPtr->~TNorm();
1357 }
1358 else {
1359 Result = BufPtr->denormalize(io);
1360 }
1361 }
1362
1363 TNorm* operator->() { return BufPtr; }
1364
1365private:
1366 using Storage = AlignedCharArrayUnion<TNorm>;
1367
1368 Storage Buffer;
1369 IO &io;
1370 TNorm *BufPtr = nullptr;
1371 TFinal &Result;
1372};
1373
1374///
1375/// The Input class is used to parse a yaml document into in-memory structs
1376/// and vectors.
1377///
1378/// It works by using YAMLParser to do a syntax parse of the entire yaml
1379/// document, then the Input class builds a graph of HNodes which wraps
1380/// each yaml Node. The extra layer is buffering. The low level yaml
1381/// parser only lets you look at each node once. The buffering layer lets
1382/// you search and interate multiple times. This is necessary because
1383/// the mapRequired() method calls may not be in the same order
1384/// as the keys in the document.
1385///
1386class Input : public IO {
1387public:
1388 // Construct a yaml Input object from a StringRef and optional
1389 // user-data. The DiagHandler can be specified to provide
1390 // alternative error reporting.
1391 Input(StringRef InputContent,
1392 void *Ctxt = nullptr,
1393 SourceMgr::DiagHandlerTy DiagHandler = nullptr,
1394 void *DiagHandlerCtxt = nullptr);
1395 Input(MemoryBufferRef Input,
1396 void *Ctxt = nullptr,
1397 SourceMgr::DiagHandlerTy DiagHandler = nullptr,
1398 void *DiagHandlerCtxt = nullptr);
1399 ~Input() override;
1400
1401 // Check if there was an syntax or semantic error during parsing.
1402 std::error_code error();
1403
1404private:
1405 bool outputting() const override;
1406 bool mapTag(StringRef, bool) override;
1407 void beginMapping() override;
1408 void endMapping() override;
1409 bool preflightKey(const char *, bool, bool, bool &, void *&) override;
1410 void postflightKey(void *) override;
1411 std::vector<StringRef> keys() override;
1412 void beginFlowMapping() override;
1413 void endFlowMapping() override;
1414 unsigned beginSequence() override;
1415 void endSequence() override;
1416 bool preflightElement(unsigned index, void *&) override;
1417 void postflightElement(void *) override;
1418 unsigned beginFlowSequence() override;
1419 bool preflightFlowElement(unsigned , void *&) override;
1420 void postflightFlowElement(void *) override;
1421 void endFlowSequence() override;
1422 void beginEnumScalar() override;
1423 bool matchEnumScalar(const char*, bool) override;
1424 bool matchEnumFallback() override;
1425 void endEnumScalar() override;
1426 bool beginBitSetScalar(bool &) override;
1427 bool bitSetMatch(const char *, bool ) override;
1428 void endBitSetScalar() override;
1429 void scalarString(StringRef &, QuotingType) override;
1430 void blockScalarString(StringRef &) override;
1431 void scalarTag(std::string &) override;
1432 NodeKind getNodeKind() override;
1433 void setError(const Twine &message) override;
1434 bool canElideEmptySequence() override;
1435
1436 class HNode {
1437 virtual void anchor();
1438
1439 public:
1440 HNode(Node *n) : _node(n) { }
1441 virtual ~HNode() = default;
1442
1443 static bool classof(const HNode *) { return true; }
1444
1445 Node *_node;
1446 };
1447
1448 class EmptyHNode : public HNode {
1449 void anchor() override;
1450
1451 public:
1452 EmptyHNode(Node *n) : HNode(n) { }
1453
1454 static bool classof(const HNode *n) { return NullNode::classof(n->_node); }
1455
1456 static bool classof(const EmptyHNode *) { return true; }
1457 };
1458
1459 class ScalarHNode : public HNode {
1460 void anchor() override;
1461
1462 public:
1463 ScalarHNode(Node *n, StringRef s) : HNode(n), _value(s) { }
1464
1465 StringRef value() const { return _value; }
1466
1467 static bool classof(const HNode *n) {
1468 return ScalarNode::classof(n->_node) ||
1469 BlockScalarNode::classof(n->_node);
1470 }
1471
1472 static bool classof(const ScalarHNode *) { return true; }
1473
1474 protected:
1475 StringRef _value;
1476 };
1477
1478 class MapHNode : public HNode {
1479 void anchor() override;
1480
1481 public:
1482 MapHNode(Node *n) : HNode(n) { }
1483
1484 static bool classof(const HNode *n) {
1485 return MappingNode::classof(n->_node);
1486 }
1487
1488 static bool classof(const MapHNode *) { return true; }
1489
1490 using NameToNode = StringMap<std::unique_ptr<HNode>>;
1491
1492 NameToNode Mapping;
1493 SmallVector<std::string, 6> ValidKeys;
1494 };
1495
1496 class SequenceHNode : public HNode {
1497 void anchor() override;
1498
1499 public:
1500 SequenceHNode(Node *n) : HNode(n) { }
1501
1502 static bool classof(const HNode *n) {
1503 return SequenceNode::classof(n->_node);
1504 }
1505
1506 static bool classof(const SequenceHNode *) { return true; }
1507
1508 std::vector<std::unique_ptr<HNode>> Entries;
1509 };
1510
1511 std::unique_ptr<Input::HNode> createHNodes(Node *node);
1512 void setError(HNode *hnode, const Twine &message);
1513 void setError(Node *node, const Twine &message);
1514
1515public:
1516 // These are only used by operator>>. They could be private
1517 // if those templated things could be made friends.
1518 bool setCurrentDocument();
1519 bool nextDocument();
1520
1521 /// Returns the current node that's being parsed by the YAML Parser.
1522 const Node *getCurrentNode() const;
1523
1524private:
1525 SourceMgr SrcMgr; // must be before Strm
1526 std::unique_ptr<llvm::yaml::Stream> Strm;
1527 std::unique_ptr<HNode> TopNode;
1528 std::error_code EC;
1529 BumpPtrAllocator StringAllocator;
1530 document_iterator DocIterator;
1531 std::vector<bool> BitValuesUsed;
1532 HNode *CurrentNode = nullptr;
1533 bool ScalarMatchFound;
1534};
1535
1536///
1537/// The Output class is used to generate a yaml document from in-memory structs
1538/// and vectors.
1539///
1540class Output : public IO {
1541public:
1542 Output(raw_ostream &, void *Ctxt = nullptr, int WrapColumn = 70);
1543 ~Output() override;
1544
1545 /// Set whether or not to output optional values which are equal
1546 /// to the default value. By default, when outputting if you attempt
1547 /// to write a value that is equal to the default, the value gets ignored.
1548 /// Sometimes, it is useful to be able to see these in the resulting YAML
1549 /// anyway.
1550 void setWriteDefaultValues(bool Write) { WriteDefaultValues = Write; }
1551
1552 bool outputting() const override;
1553 bool mapTag(StringRef, bool) override;
1554 void beginMapping() override;
1555 void endMapping() override;
1556 bool preflightKey(const char *key, bool, bool, bool &, void *&) override;
1557 void postflightKey(void *) override;
1558 std::vector<StringRef> keys() override;
1559 void beginFlowMapping() override;
1560 void endFlowMapping() override;
1561 unsigned beginSequence() override;
1562 void endSequence() override;
1563 bool preflightElement(unsigned, void *&) override;
1564 void postflightElement(void *) override;
1565 unsigned beginFlowSequence() override;
1566 bool preflightFlowElement(unsigned, void *&) override;
1567 void postflightFlowElement(void *) override;
1568 void endFlowSequence() override;
1569 void beginEnumScalar() override;
1570 bool matchEnumScalar(const char*, bool) override;
1571 bool matchEnumFallback() override;
1572 void endEnumScalar() override;
1573 bool beginBitSetScalar(bool &) override;
1574 bool bitSetMatch(const char *, bool ) override;
1575 void endBitSetScalar() override;
1576 void scalarString(StringRef &, QuotingType) override;
1577 void blockScalarString(StringRef &) override;
1578 void scalarTag(std::string &) override;
1579 NodeKind getNodeKind() override;
1580 void setError(const Twine &message) override;
1581 bool canElideEmptySequence() override;
1582
1583 // These are only used by operator<<. They could be private
1584 // if that templated operator could be made a friend.
1585 void beginDocuments();
1586 bool preflightDocument(unsigned);
1587 void postflightDocument();
1588 void endDocuments();
1589
1590private:
1591 void output(StringRef s);
1592 void outputUpToEndOfLine(StringRef s);
1593 void newLineCheck();
1594 void outputNewLine();
1595 void paddedKey(StringRef key);
1596 void flowKey(StringRef Key);
1597
1598 enum InState {
1599 inSeqFirstElement,
1600 inSeqOtherElement,
1601 inFlowSeqFirstElement,
1602 inFlowSeqOtherElement,
1603 inMapFirstKey,
1604 inMapOtherKey,
1605 inFlowMapFirstKey,
1606 inFlowMapOtherKey
1607 };
1608
1609 static bool inSeqAnyElement(InState State);
1610 static bool inFlowSeqAnyElement(InState State);
1611 static bool inMapAnyKey(InState State);
1612 static bool inFlowMapAnyKey(InState State);
1613
1614 raw_ostream &Out;
1615 int WrapColumn;
1616 SmallVector<InState, 8> StateStack;
1617 int Column = 0;
1618 int ColumnAtFlowStart = 0;
1619 int ColumnAtMapFlowStart = 0;
1620 bool NeedBitValueComma = false;
1621 bool NeedFlowSequenceComma = false;
1622 bool EnumerationMatchFound = false;
1623 bool WriteDefaultValues = false;
1624 StringRef Padding;
1625 StringRef PaddingBeforeContainer;
1626};
1627
1628/// YAML I/O does conversion based on types. But often native data types
1629/// are just a typedef of built in intergral types (e.g. int). But the C++
1630/// type matching system sees through the typedef and all the typedefed types
1631/// look like a built in type. This will cause the generic YAML I/O conversion
1632/// to be used. To provide better control over the YAML conversion, you can
1633/// use this macro instead of typedef. It will create a class with one field
1634/// and automatic conversion operators to and from the base type.
1635/// Based on BOOST_STRONG_TYPEDEF
1636#define LLVM_YAML_STRONG_TYPEDEF(_base, _type)struct _type { _type() = default; _type(const _base v) : value
(v) {} _type(const _type &v) = default; _type &operator
=(const _type &rhs) = default; _type &operator=(const
_base &rhs) { value = rhs; return *this; } operator const
_base & () const { return value; } bool operator==(const
_type &rhs) const { return value == rhs.value; } bool operator
==(const _base &rhs) const { return value == rhs; } bool operator
<(const _type &rhs) const { return value < rhs.value
; } _base value; using BaseType = _base; };
\
1637 struct _type { \
1638 _type() = default; \
1639 _type(const _base v) : value(v) {} \
1640 _type(const _type &v) = default; \
1641 _type &operator=(const _type &rhs) = default; \
1642 _type &operator=(const _base &rhs) { value = rhs; return *this; } \
1643 operator const _base & () const { return value; } \
1644 bool operator==(const _type &rhs) const { return value == rhs.value; } \
1645 bool operator==(const _base &rhs) const { return value == rhs; } \
1646 bool operator<(const _type &rhs) const { return value < rhs.value; } \
1647 _base value; \
1648 using BaseType = _base; \
1649 };
1650
1651///
1652/// Use these types instead of uintXX_t in any mapping to have
1653/// its yaml output formatted as hexadecimal.
1654///
1655LLVM_YAML_STRONG_TYPEDEF(uint8_t, Hex8)struct Hex8 { Hex8() = default; Hex8(const uint8_t v) : value
(v) {} Hex8(const Hex8 &v) = default; Hex8 &operator=
(const Hex8 &rhs) = default; Hex8 &operator=(const uint8_t
&rhs) { value = rhs; return *this; } operator const uint8_t
& () const { return value; } bool operator==(const Hex8 &
rhs) const { return value == rhs.value; } bool operator==(const
uint8_t &rhs) const { return value == rhs; } bool operator
<(const Hex8 &rhs) const { return value < rhs.value
; } uint8_t value; using BaseType = uint8_t; };
1656LLVM_YAML_STRONG_TYPEDEF(uint16_t, Hex16)struct Hex16 { Hex16() = default; Hex16(const uint16_t v) : value
(v) {} Hex16(const Hex16 &v) = default; Hex16 &operator
=(const Hex16 &rhs) = default; Hex16 &operator=(const
uint16_t &rhs) { value = rhs; return *this; } operator const
uint16_t & () const { return value; } bool operator==(const
Hex16 &rhs) const { return value == rhs.value; } bool operator
==(const uint16_t &rhs) const { return value == rhs; } bool
operator<(const Hex16 &rhs) const { return value <
rhs.value; } uint16_t value; using BaseType = uint16_t; };
1657LLVM_YAML_STRONG_TYPEDEF(uint32_t, Hex32)struct Hex32 { Hex32() = default; Hex32(const uint32_t v) : value
(v) {} Hex32(const Hex32 &v) = default; Hex32 &operator
=(const Hex32 &rhs) = default; Hex32 &operator=(const
uint32_t &rhs) { value = rhs; return *this; } operator const
uint32_t & () const { return value; } bool operator==(const
Hex32 &rhs) const { return value == rhs.value; } bool operator
==(const uint32_t &rhs) const { return value == rhs; } bool
operator<(const Hex32 &rhs) const { return value <
rhs.value; } uint32_t value; using BaseType = uint32_t; };
1658LLVM_YAML_STRONG_TYPEDEF(uint64_t, Hex64)struct Hex64 { Hex64() = default; Hex64(const uint64_t v) : value
(v) {} Hex64(const Hex64 &v) = default; Hex64 &operator
=(const Hex64 &rhs) = default; Hex64 &operator=(const
uint64_t &rhs) { value = rhs; return *this; } operator const
uint64_t & () const { return value; } bool operator==(const
Hex64 &rhs) const { return value == rhs.value; } bool operator
==(const uint64_t &rhs) const { return value == rhs; } bool
operator<(const Hex64 &rhs) const { return value <
rhs.value; } uint64_t value; using BaseType = uint64_t; };
1659
1660template<>
1661struct ScalarTraits<Hex8> {
1662 static void output(const Hex8 &, void *, raw_ostream &);
1663 static StringRef input(StringRef, void *, Hex8 &);
1664 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1665};
1666
1667template<>
1668struct ScalarTraits<Hex16> {
1669 static void output(const Hex16 &, void *, raw_ostream &);
1670 static StringRef input(StringRef, void *, Hex16 &);
1671 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1672};
1673
1674template<>
1675struct ScalarTraits<Hex32> {
1676 static void output(const Hex32 &, void *, raw_ostream &);
1677 static StringRef input(StringRef, void *, Hex32 &);
1678 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1679};
1680
1681template<>
1682struct ScalarTraits<Hex64> {
1683 static void output(const Hex64 &, void *, raw_ostream &);
1684 static StringRef input(StringRef, void *, Hex64 &);
1685 static QuotingType mustQuote(StringRef) { return QuotingType::None; }
1686};
1687
1688// Define non-member operator>> so that Input can stream in a document list.
1689template <typename T>
1690inline
1691typename std::enable_if<has_DocumentListTraits<T>::value, Input &>::type
1692operator>>(Input &yin, T &docList) {
1693 int i = 0;
1694 EmptyContext Ctx;
1695 while ( yin.setCurrentDocument() ) {
1696 yamlize(yin, DocumentListTraits<T>::element(yin, docList, i), true, Ctx);
1697 if ( yin.error() )
1698 return yin;
1699 yin.nextDocument();
1700 ++i;
1701 }
1702 return yin;
1703}
1704
1705// Define non-member operator>> so that Input can stream in a map as a document.
1706template <typename T>
1707inline typename std::enable_if<has_MappingTraits<T, EmptyContext>::value,
1708 Input &>::type
1709operator>>(Input &yin, T &docMap) {
1710 EmptyContext Ctx;
1711 yin.setCurrentDocument();
1712 yamlize(yin, docMap, true, Ctx);
1713 return yin;
1714}
1715
1716// Define non-member operator>> so that Input can stream in a sequence as
1717// a document.
1718template <typename T>
1719inline
1720typename std::enable_if<has_SequenceTraits<T>::value, Input &>::type
1721operator>>(Input &yin, T &docSeq) {
1722 EmptyContext Ctx;
1723 if (yin.setCurrentDocument())
1724 yamlize(yin, docSeq, true, Ctx);
1725 return yin;
1726}
1727
1728// Define non-member operator>> so that Input can stream in a block scalar.
1729template <typename T>
1730inline
1731typename std::enable_if<has_BlockScalarTraits<T>::value, Input &>::type
1732operator>>(Input &In, T &Val) {
1733 EmptyContext Ctx;
1734 if (In.setCurrentDocument())
1735 yamlize(In, Val, true, Ctx);
1736 return In;
1737}
1738
1739// Define non-member operator>> so that Input can stream in a string map.
1740template <typename T>
1741inline
1742typename std::enable_if<has_CustomMappingTraits<T>::value, Input &>::type
1743operator>>(Input &In, T &Val) {
1744 EmptyContext Ctx;
1745 if (In.setCurrentDocument())
1746 yamlize(In, Val, true, Ctx);
1747 return In;
1748}
1749
1750// Define non-member operator>> so that Input can stream in a polymorphic type.
1751template <typename T>
1752inline typename std::enable_if<has_PolymorphicTraits<T>::value, Input &>::type
1753operator>>(Input &In, T &Val) {
1754 EmptyContext Ctx;
1755 if (In.setCurrentDocument())
1756 yamlize(In, Val, true, Ctx);
1757 return In;
1758}
1759
1760// Provide better error message about types missing a trait specialization
1761template <typename T>
1762inline typename std::enable_if<missingTraits<T, EmptyContext>::value,
1763 Input &>::type
1764operator>>(Input &yin, T &docSeq) {
1765 char missing_yaml_trait_for_type[sizeof(MissingTrait<T>)];
1766 return yin;
1767}
1768
1769// Define non-member operator<< so that Output can stream out document list.
1770template <typename T>
1771inline
1772typename std::enable_if<has_DocumentListTraits<T>::value, Output &>::type
1773operator<<(Output &yout, T &docList) {
1774 EmptyContext Ctx;
1775 yout.beginDocuments();
1776 const size_t count = DocumentListTraits<T>::size(yout, docList);
1777 for(size_t i=0; i < count; ++i) {
1778 if ( yout.preflightDocument(i) ) {
1779 yamlize(yout, DocumentListTraits<T>::element(yout, docList, i), true,
1780 Ctx);
1781 yout.postflightDocument();
1782 }
1783 }
1784 yout.endDocuments();
1785 return yout;
1786}
1787
1788// Define non-member operator<< so that Output can stream out a map.
1789template <typename T>
1790inline typename std::enable_if<has_MappingTraits<T, EmptyContext>::value,
1791 Output &>::type
1792operator<<(Output &yout, T &map) {
1793 EmptyContext Ctx;
1794 yout.beginDocuments();
1795 if ( yout.preflightDocument(0) ) {
1796 yamlize(yout, map, true, Ctx);
1797 yout.postflightDocument();
1798 }
1799 yout.endDocuments();
1800 return yout;
1801}
1802
1803// Define non-member operator<< so that Output can stream out a sequence.
1804template <typename T>
1805inline
1806typename std::enable_if<has_SequenceTraits<T>::value, Output &>::type
1807operator<<(Output &yout, T &seq) {
1808 EmptyContext Ctx;
1809 yout.beginDocuments();
1810 if ( yout.preflightDocument(0) ) {
1811 yamlize(yout, seq, true, Ctx);
1812 yout.postflightDocument();
1813 }
1814 yout.endDocuments();
1815 return yout;
1816}
1817
1818// Define non-member operator<< so that Output can stream out a block scalar.
1819template <typename T>
1820inline
1821typename std::enable_if<has_BlockScalarTraits<T>::value, Output &>::type
1822operator<<(Output &Out, T &Val) {
1823 EmptyContext Ctx;
1824 Out.beginDocuments();
1825 if (Out.preflightDocument(0)) {
1826 yamlize(Out, Val, true, Ctx);
1827 Out.postflightDocument();
1828 }
1829 Out.endDocuments();
1830 return Out;
1831}
1832
1833// Define non-member operator<< so that Output can stream out a string map.
1834template <typename T>
1835inline
1836typename std::enable_if<has_CustomMappingTraits<T>::value, Output &>::type
1837operator<<(Output &Out, T &Val) {
1838 EmptyContext Ctx;
1839 Out.beginDocuments();
1840 if (Out.preflightDocument(0)) {
1841 yamlize(Out, Val, true, Ctx);
1842 Out.postflightDocument();
1843 }
1844 Out.endDocuments();
1845 return Out;
1846}
1847
1848// Define non-member operator<< so that Output can stream out a polymorphic
1849// type.
1850template <typename T>
1851inline typename std::enable_if<has_PolymorphicTraits<T>::value, Output &>::type
1852operator<<(Output &Out, T &Val) {
1853 EmptyContext Ctx;
1854 Out.beginDocuments();
1855 if (Out.preflightDocument(0)) {
1856 // FIXME: The parser does not support explicit documents terminated with a
1857 // plain scalar; the end-marker is included as part of the scalar token.
1858 assert(PolymorphicTraits<T>::getKind(Val) != NodeKind::Scalar && "plain scalar documents are not supported")((PolymorphicTraits<T>::getKind(Val) != NodeKind::Scalar
&& "plain scalar documents are not supported") ? static_cast
<void> (0) : __assert_fail ("PolymorphicTraits<T>::getKind(Val) != NodeKind::Scalar && \"plain scalar documents are not supported\""
, "/build/llvm-toolchain-snapshot-10~svn374814/include/llvm/Support/YAMLTraits.h"
, 1858, __PRETTY_FUNCTION__))
;
1859 yamlize(Out, Val, true, Ctx);
1860 Out.postflightDocument();
1861 }
1862 Out.endDocuments();
1863 return Out;
1864}
1865
1866// Provide better error message about types missing a trait specialization
1867template <typename T>
1868inline typename std::enable_if<missingTraits<T, EmptyContext>::value,
1869 Output &>::type
1870operator<<(Output &yout, T &seq) {
1871 char missing_yaml_trait_for_type[sizeof(MissingTrait<T>)];
1872 return yout;
1873}
1874
1875template <bool B> struct IsFlowSequenceBase {};
1876template <> struct IsFlowSequenceBase<true> { static const bool flow = true; };
1877
1878template <typename T, bool Flow>
1879struct SequenceTraitsImpl : IsFlowSequenceBase<Flow> {
1880private:
1881 using type = typename T::value_type;
1882
1883public:
1884 static size_t size(IO &io, T &seq) { return seq.size(); }
1885
1886 static type &element(IO &io, T &seq, size_t index) {
1887 if (index >= seq.size())
1888 seq.resize(index + 1);
1889 return seq[index];
1890 }
1891};
1892
1893// Simple helper to check an expression can be used as a bool-valued template
1894// argument.
1895template <bool> struct CheckIsBool { static const bool value = true; };
1896
1897// If T has SequenceElementTraits, then vector<T> and SmallVector<T, N> have
1898// SequenceTraits that do the obvious thing.
1899template <typename T>
1900struct SequenceTraits<std::vector<T>,
1901 typename std::enable_if<CheckIsBool<
1902 SequenceElementTraits<T>::flow>::value>::type>
1903 : SequenceTraitsImpl<std::vector<T>, SequenceElementTraits<T>::flow> {};
1904template <typename T, unsigned N>
1905struct SequenceTraits<SmallVector<T, N>,
1906 typename std::enable_if<CheckIsBool<
1907 SequenceElementTraits<T>::flow>::value>::type>
1908 : SequenceTraitsImpl<SmallVector<T, N>, SequenceElementTraits<T>::flow> {};
1909template <typename T>
1910struct SequenceTraits<SmallVectorImpl<T>,
1911 typename std::enable_if<CheckIsBool<
1912 SequenceElementTraits<T>::flow>::value>::type>
1913 : SequenceTraitsImpl<SmallVectorImpl<T>, SequenceElementTraits<T>::flow> {};
1914
1915// Sequences of fundamental types use flow formatting.
1916template <typename T>
1917struct SequenceElementTraits<
1918 T, typename std::enable_if<std::is_fundamental<T>::value>::type> {
1919 static const bool flow = true;
1920};
1921
1922// Sequences of strings use block formatting.
1923template<> struct SequenceElementTraits<std::string> {
1924 static const bool flow = false;
1925};
1926template<> struct SequenceElementTraits<StringRef> {
1927 static const bool flow = false;
1928};
1929template<> struct SequenceElementTraits<std::pair<std::string, std::string>> {
1930 static const bool flow = false;
1931};
1932
1933/// Implementation of CustomMappingTraits for std::map<std::string, T>.
1934template <typename T> struct StdMapStringCustomMappingTraitsImpl {
1935 using map_type = std::map<std::string, T>;
1936
1937 static void inputOne(IO &io, StringRef key, map_type &v) {
1938 io.mapRequired(key.str().c_str(), v[key]);
1939 }
1940
1941 static void output(IO &io, map_type &v) {
1942 for (auto &p : v)
1943 io.mapRequired(p.first.c_str(), p.second);
1944 }
1945};
1946
1947} // end namespace yaml
1948} // end namespace llvm
1949
1950#define LLVM_YAML_IS_SEQUENCE_VECTOR_IMPL(TYPE, FLOW)namespace llvm { namespace yaml { static_assert( !std::is_fundamental
<TYPE>::value && !std::is_same<TYPE, std::string
>::value && !std::is_same<TYPE, llvm::StringRef
>::value, "only use LLVM_YAML_IS_SEQUENCE_VECTOR for types you control"
); template <> struct SequenceElementTraits<TYPE>
{ static const bool flow = FLOW; }; } }
\
1951 namespace llvm { \
1952 namespace yaml { \
1953 static_assert( \
1954 !std::is_fundamental<TYPE>::value && \
1955 !std::is_same<TYPE, std::string>::value && \
1956 !std::is_same<TYPE, llvm::StringRef>::value, \
1957 "only use LLVM_YAML_IS_SEQUENCE_VECTOR for types you control"); \
1958 template <> struct SequenceElementTraits<TYPE> { \
1959 static const bool flow = FLOW; \
1960 }; \
1961 } \
1962 }
1963
1964/// Utility for declaring that a std::vector of a particular type
1965/// should be considered a YAML sequence.
1966#define LLVM_YAML_IS_SEQUENCE_VECTOR(type)namespace llvm { namespace yaml { static_assert( !std::is_fundamental
<type>::value && !std::is_same<type, std::string
>::value && !std::is_same<type, llvm::StringRef
>::value, "only use LLVM_YAML_IS_SEQUENCE_VECTOR for types you control"
); template <> struct SequenceElementTraits<type>
{ static const bool flow = false; }; } }
\
1967 LLVM_YAML_IS_SEQUENCE_VECTOR_IMPL(type, false)namespace llvm { namespace yaml { static_assert( !std::is_fundamental
<type>::value && !std::is_same<type, std::string
>::value && !std::is_same<type, llvm::StringRef
>::value, "only use LLVM_YAML_IS_SEQUENCE_VECTOR for types you control"
); template <> struct SequenceElementTraits<type>
{ static const bool flow = false; }; } }
1968
1969/// Utility for declaring that a std::vector of a particular type
1970/// should be considered a YAML flow sequence.
1971#define LLVM_YAML_IS_FLOW_SEQUENCE_VECTOR(type)namespace llvm { namespace yaml { static_assert( !std::is_fundamental
<type>::value && !std::is_same<type, std::string
>::value && !std::is_same<type, llvm::StringRef
>::value, "only use LLVM_YAML_IS_SEQUENCE_VECTOR for types you control"
); template <> struct SequenceElementTraits<type>
{ static const bool flow = true; }; } }
\
1972 LLVM_YAML_IS_SEQUENCE_VECTOR_IMPL(type, true)namespace llvm { namespace yaml { static_assert( !std::is_fundamental
<type>::value && !std::is_same<type, std::string
>::value && !std::is_same<type, llvm::StringRef
>::value, "only use LLVM_YAML_IS_SEQUENCE_VECTOR for types you control"
); template <> struct SequenceElementTraits<type>
{ static const bool flow = true; }; } }
1973
1974#define LLVM_YAML_DECLARE_MAPPING_TRAITS(Type)namespace llvm { namespace yaml { template <> struct MappingTraits
<Type> { static void mapping(IO &IO, Type &Obj)
; }; } }
\
1975 namespace llvm { \
1976 namespace yaml { \
1977 template <> struct MappingTraits<Type> { \
1978 static void mapping(IO &IO, Type &Obj); \
1979 }; \
1980 } \
1981 }
1982
1983#define LLVM_YAML_DECLARE_ENUM_TRAITS(Type)namespace llvm { namespace yaml { template <> struct ScalarEnumerationTraits
<Type> { static void enumeration(IO &io, Type &
Value); }; } }
\
1984 namespace llvm { \
1985 namespace yaml { \
1986 template <> struct ScalarEnumerationTraits<Type> { \
1987 static void enumeration(IO &io, Type &Value); \
1988 }; \
1989 } \
1990 }
1991
1992#define LLVM_YAML_DECLARE_BITSET_TRAITS(Type)namespace llvm { namespace yaml { template <> struct ScalarBitSetTraits
<Type> { static void bitset(IO &IO, Type &Options
); }; } }
\
1993 namespace llvm { \
1994 namespace yaml { \
1995 template <> struct ScalarBitSetTraits<Type> { \
1996 static void bitset(IO &IO, Type &Options); \
1997 }; \
1998 } \
1999 }
2000
2001#define LLVM_YAML_DECLARE_SCALAR_TRAITS(Type, MustQuote)namespace llvm { namespace yaml { template <> struct ScalarTraits
<Type> { static void output(const Type &Value, void
*ctx, raw_ostream &Out); static StringRef input(StringRef
Scalar, void *ctxt, Type &Value); static QuotingType mustQuote
(StringRef) { return MustQuote; } }; } }
\
2002 namespace llvm { \
2003 namespace yaml { \
2004 template <> struct ScalarTraits<Type> { \
2005 static void output(const Type &Value, void *ctx, raw_ostream &Out); \
2006 static StringRef input(StringRef Scalar, void *ctxt, Type &Value); \
2007 static QuotingType mustQuote(StringRef) { return MustQuote; } \
2008 }; \
2009 } \
2010 }
2011
2012/// Utility for declaring that a std::vector of a particular type
2013/// should be considered a YAML document list.
2014#define LLVM_YAML_IS_DOCUMENT_LIST_VECTOR(_type)namespace llvm { namespace yaml { template <unsigned N>
struct DocumentListTraits<SmallVector<_type, N>>
: public SequenceTraitsImpl<SmallVector<_type, N>, false
> {}; template <> struct DocumentListTraits<std::
vector<_type>> : public SequenceTraitsImpl<std::vector
<_type>, false> {}; } }
\
2015 namespace llvm { \
2016 namespace yaml { \
2017 template <unsigned N> \
2018 struct DocumentListTraits<SmallVector<_type, N>> \
2019 : public SequenceTraitsImpl<SmallVector<_type, N>, false> {}; \
2020 template <> \
2021 struct DocumentListTraits<std::vector<_type>> \
2022 : public SequenceTraitsImpl<std::vector<_type>, false> {}; \
2023 } \
2024 }
2025
2026/// Utility for declaring that std::map<std::string, _type> should be considered
2027/// a YAML map.
2028#define LLVM_YAML_IS_STRING_MAP(_type)namespace llvm { namespace yaml { template <> struct CustomMappingTraits
<std::map<std::string, _type>> : public StdMapStringCustomMappingTraitsImpl
<_type> {}; } }
\
2029 namespace llvm { \
2030 namespace yaml { \
2031 template <> \
2032 struct CustomMappingTraits<std::map<std::string, _type>> \
2033 : public StdMapStringCustomMappingTraitsImpl<_type> {}; \
2034 } \
2035 }
2036
2037#endif // LLVM_SUPPORT_YAMLTRAITS_H