LLVM  4.0.0
RecordSerialization.cpp
Go to the documentation of this file.
1 //===-- RecordSerialization.cpp -------------------------------------------===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // Utilities for serializing and deserializing CodeView records.
11 //
12 //===----------------------------------------------------------------------===//
13 
15 #include "llvm/ADT/APInt.h"
16 #include "llvm/ADT/APSInt.h"
20 
21 using namespace llvm;
22 using namespace llvm::codeview;
23 using namespace llvm::support;
24 
25 /// Reinterpret a byte array as an array of characters. Does not interpret as
26 /// a C string, as StringRef has several helpers (split) that make that easy.
28  return StringRef(reinterpret_cast<const char *>(LeafData.data()),
29  LeafData.size());
30 }
31 
33  return getBytesAsCharacters(LeafData).split('\0').first;
34 }
35 
37  // Used to avoid overload ambiguity on APInt construtor.
38  bool FalseVal = false;
39  uint16_t Short;
40  if (auto EC = Reader.readInteger(Short))
41  return EC;
42 
43  if (Short < LF_NUMERIC) {
44  Num = APSInt(APInt(/*numBits=*/16, Short, /*isSigned=*/false),
45  /*isUnsigned=*/true);
46  return Error::success();
47  }
48 
49  switch (Short) {
50  case LF_CHAR: {
51  int8_t N;
52  if (auto EC = Reader.readInteger(N))
53  return EC;
54  Num = APSInt(APInt(8, N, true), false);
55  return Error::success();
56  }
57  case LF_SHORT: {
58  int16_t N;
59  if (auto EC = Reader.readInteger(N))
60  return EC;
61  Num = APSInt(APInt(16, N, true), false);
62  return Error::success();
63  }
64  case LF_USHORT: {
65  uint16_t N;
66  if (auto EC = Reader.readInteger(N))
67  return EC;
68  Num = APSInt(APInt(16, N, false), true);
69  return Error::success();
70  }
71  case LF_LONG: {
72  int32_t N;
73  if (auto EC = Reader.readInteger(N))
74  return EC;
75  Num = APSInt(APInt(32, N, true), false);
76  return Error::success();
77  }
78  case LF_ULONG: {
79  uint32_t N;
80  if (auto EC = Reader.readInteger(N))
81  return EC;
82  Num = APSInt(APInt(32, N, FalseVal), true);
83  return Error::success();
84  }
85  case LF_QUADWORD: {
86  int64_t N;
87  if (auto EC = Reader.readInteger(N))
88  return EC;
89  Num = APSInt(APInt(64, N, true), false);
90  return Error::success();
91  }
92  case LF_UQUADWORD: {
93  uint64_t N;
94  if (auto EC = Reader.readInteger(N))
95  return EC;
96  Num = APSInt(APInt(64, N, false), true);
97  return Error::success();
98  }
99  }
100  return make_error<CodeViewError>(cv_error_code::corrupt_record,
101  "Buffer contains invalid APSInt type");
102 }
103 
105  ArrayRef<uint8_t> Bytes(Data.bytes_begin(), Data.bytes_end());
106  msf::ByteStream S(Bytes);
107  msf::StreamReader SR(S);
108  auto EC = consume(SR, Num);
109  Data = Data.take_back(SR.bytesRemaining());
110  return EC;
111 }
112 
113 /// Decode a numeric leaf value that is known to be a uint64_t.
115  uint64_t &Num) {
116  APSInt N;
117  if (auto EC = consume(Reader, N))
118  return EC;
119  if (N.isSigned() || !N.isIntN(64))
120  return make_error<CodeViewError>(cv_error_code::corrupt_record,
121  "Data is not a numeric value!");
122  Num = N.getLimitedValue();
123  return Error::success();
124 }
125 
127  return Reader.readInteger(Item);
128 }
129 
131  ArrayRef<uint8_t> Bytes(Data.bytes_begin(), Data.bytes_end());
132  msf::ByteStream S(Bytes);
133  msf::StreamReader SR(S);
134  auto EC = consume(SR, Item);
135  Data = Data.take_back(SR.bytesRemaining());
136  return EC;
137 }
138 
140  return Reader.readInteger(Item);
141 }
142 
144  if (Reader.empty())
145  return make_error<CodeViewError>(cv_error_code::corrupt_record,
146  "Null terminated string buffer is empty!");
147 
148  return Reader.readZeroString(Item);
149 }
LLVM_NODISCARD LLVM_ATTRIBUTE_ALWAYS_INLINE StringRef take_back(size_t N=1) const
Return a StringRef equal to 'this' but with only the first N elements remaining.
Definition: StringRef.h:608
Error consume(msf::StreamReader &Reader)
const unsigned char * bytes_end() const
Definition: StringRef.h:110
uint64_t getLimitedValue(uint64_t Limit=~0ULL) const
If this value is smaller than the specified limit, return it, otherwise return the limit value...
Definition: APInt.h:409
bool isSigned() const
Definition: APSInt.h:59
Error readZeroString(StringRef &Dest)
bool isIntN(unsigned N) const
Check if this APInt has an N-bits unsigned integer value.
Definition: APInt.h:377
This file implements a class to represent arbitrary precision integral constant values and operations...
size_t size() const
size - Get the array size.
Definition: ArrayRef.h:141
Error readInteger(uint8_t &Dest)
static ErrorSuccess success()
Create a success value.
Class for arbitrary precision integers.
Definition: APInt.h:77
LLVM_NODISCARD std::pair< StringRef, StringRef > split(char Separator) const
Split into two substrings around the first occurrence of a separator character.
Definition: StringRef.h:716
StringRef getBytesAsCharacters(ArrayRef< uint8_t > LeafData)
Reinterpret a byte array as an array of characters.
StringRef getBytesAsCString(ArrayRef< uint8_t > LeafData)
#define N
Error consume_numeric(msf::StreamReader &Reader, uint64_t &Value)
Decodes a numeric leaf value that is known to be a particular type.
uint32_t bytesRemaining() const
Definition: StreamReader.h:108
const unsigned char * bytes_begin() const
Definition: StringRef.h:107
Lightweight error class with error context and mandatory checking.
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:47
const T * data() const
Definition: ArrayRef.h:138