1 //=- Deserialize.h - Generic Object Deserialization from Bitcode --*- C++ -*-=//
3 // The LLVM Compiler Infrastructure
5 // This file was developed by Ted Kremenek and is distributed under the
6 // University of Illinois Open Source License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines the interface for generic object deserialization from
13 //===----------------------------------------------------------------------===//
15 #ifndef LLVM_BITCODE_SERIALIZE_INPUT
16 #define LLVM_BITCODE_SERIALIZE_INPUT
18 #include "llvm/Bitcode/BitstreamReader.h"
19 #include "llvm/Bitcode/Serialization.h"
20 #include "llvm/ADT/DenseMap.h"
21 #include "llvm/ADT/SmallVector.h"
22 #include "llvm/Support/Allocator.h"
23 #include "llvm/Support/DataTypes.h"
30 //===----------------------------------------------------------===//
31 // Internal type definitions.
32 //===----------------------------------------------------------===//
38 BPNode(BPNode* n, uintptr_t& pref)
39 : Next(n), PtrRef(pref) {
45 union { BPNode* Head; void* Ptr; };
47 BPEntry() : Head(NULL) {}
49 static inline bool isPod() { return true; }
51 void SetPtr(BPNode*& FreeList, void* P);
58 BPKey(SerializedPtrID PtrId) : Raw(PtrId << 1) { assert (PtrId > 0); }
59 BPKey(unsigned code, unsigned) : Raw(code) {}
61 void MarkFinal() { Raw |= 0x1; }
62 bool hasFinalPtr() const { return Raw & 0x1 ? true : false; }
63 SerializedPtrID getID() const { return Raw >> 1; }
65 static inline BPKey getEmptyKey() { return BPKey(0,0); }
66 static inline BPKey getTombstoneKey() { return BPKey(1,0); }
67 static inline unsigned getHashValue(const BPKey& K) { return K.Raw & ~0x1; }
69 static bool isEqual(const BPKey& K1, const BPKey& K2) {
70 return (K1.Raw ^ K2.Raw) & ~0x1 ? false : true;
73 static bool isPod() { return true; }
76 typedef llvm::DenseMap<BPKey,BPEntry,BPKey,BPEntry> MapTy;
78 //===----------------------------------------------------------===//
79 // Publicly visible types.
80 //===----------------------------------------------------------===//
88 Location(uint64_t bit, unsigned bid, unsigned words)
89 : BitNo(bit), BlockID(bid), NumWords(words) {}
91 Location() : BitNo(0), BlockID(0), NumWords(0) {}
93 Location& operator=(Location& RHS) {
95 BlockID = RHS.BlockID;
96 NumWords = RHS.NumWords;
100 bool operator==(const Location& RHS) const { return BitNo == RHS.BitNo; }
101 bool operator!=(const Location& RHS) const { return BitNo != RHS.BitNo; }
103 bool contains(const Location& RHS) const {
104 if (RHS.BitNo < BitNo)
107 if ((RHS.BitNo - BitNo) >> 5 < NumWords)
114 //===----------------------------------------------------------===//
115 // Internal data members.
116 //===----------------------------------------------------------===//
119 BitstreamReader& Stream;
120 SmallVector<uint64_t,20> Record;
122 BumpPtrAllocator Allocator;
125 llvm::SmallVector<Location,8> BlockStack;
128 Location StreamStart;
129 std::vector<SerializedPtrID> BatchIDVec;
131 //===----------------------------------------------------------===//
133 //===----------------------------------------------------------===//
136 Deserializer(BitstreamReader& stream);
141 SerializedPtrID ReadPtrID() { return (SerializedPtrID) ReadInt(); }
145 return ReadInt() ? true : false;
148 template <typename T>
149 inline T& Read(T& X) {
150 SerializeTrait<T>::Read(*this,X);
154 template <typename T>
155 inline T* Materialize() {
156 return SerializeTrait<T>::Materialize(*this);
159 char* ReadCStr(char* cstr = NULL, unsigned MaxLen=0, bool isNullTerm=true);
160 void ReadCStr(std::vector<char>& buff, bool isNullTerm=false);
162 template <typename T>
163 inline T* ReadOwnedPtr(bool AutoRegister = true) {
164 SerializedPtrID PtrID = ReadPtrID();
169 T* x = SerializeTrait<T>::Materialize(*this);
172 RegisterPtr(PtrID,x);
177 template <typename T>
178 inline void ReadOwnedPtr(T*& Ptr, bool AutoRegister = true) {
179 Ptr = ReadOwnedPtr<T>(AutoRegister);
182 template <typename T1, typename T2>
183 void BatchReadOwnedPtrs(T1*& P1, T2*& P2,
184 bool A1=true, bool A2=true) {
186 SerializedPtrID ID1 = ReadPtrID();
187 SerializedPtrID ID2 = ReadPtrID();
189 P1 = (ID1) ? SerializeTrait<T1>::Materialize(*this) : NULL;
190 if (ID1 && A1) RegisterPtr(ID1,P1);
192 P2 = (ID2) ? SerializeTrait<T2>::Materialize(*this) : NULL;
193 if (ID2 && A2) RegisterPtr(ID2,P2);
196 template <typename T1, typename T2, typename T3>
197 void BatchReadOwnedPtrs(T1*& P1, T2*& P2, T3*& P3,
198 bool A1=true, bool A2=true, bool A3=true) {
200 SerializedPtrID ID1 = ReadPtrID();
201 SerializedPtrID ID2 = ReadPtrID();
202 SerializedPtrID ID3 = ReadPtrID();
204 P1 = (ID1) ? SerializeTrait<T1>::Materialize(*this) : NULL;
205 if (ID1 && A1) RegisterPtr(ID1,P1);
207 P2 = (ID2) ? SerializeTrait<T2>::Materialize(*this) : NULL;
208 if (ID2 && A2) RegisterPtr(ID2,P2);
210 P3 = (ID3) ? SerializeTrait<T2>::Materialize(*this) : NULL;
211 if (ID3 && A3) RegisterPtr(ID3,P3);
214 template <typename T>
215 void BatchReadOwnedPtrs(unsigned NumPtrs, T** Ptrs, bool AutoRegister=true) {
218 for (unsigned i = 0; i < NumPtrs; ++i)
219 BatchIDVec.push_back(ReadPtrID());
221 for (unsigned i = 0; i < NumPtrs; ++i) {
222 SerializedPtrID& PtrID = BatchIDVec[i];
224 T* p = PtrID ? SerializeTrait<T>::Materialize(*this) : NULL;
226 if (PtrID && AutoRegister)
227 RegisterPtr(PtrID,p);
233 template <typename T1, typename T2, typename T3>
234 void BatchReadOwnedPtrs(unsigned NumT1Ptrs, T1** Ptrs,
236 bool A1=true, bool A2=true, bool A3=true) {
240 for (unsigned i = 0; i < NumT1Ptrs; ++i)
241 BatchIDVec.push_back(ReadPtrID());
243 SerializedPtrID ID2 = ReadPtrID();
244 SerializedPtrID ID3 = ReadPtrID();
246 for (unsigned i = 0; i < NumT1Ptrs; ++i) {
247 SerializedPtrID& PtrID = BatchIDVec[i];
249 T1* p = PtrID ? SerializeTrait<T1>::Materialize(*this) : NULL;
252 RegisterPtr(PtrID,p);
257 P2 = (ID2) ? SerializeTrait<T2>::Materialize(*this) : NULL;
258 if (ID2 && A2) RegisterPtr(ID2,P2);
260 P3 = (ID3) ? SerializeTrait<T3>::Materialize(*this) : NULL;
261 if (ID3 && A3) RegisterPtr(ID3,P3);
264 template <typename T>
265 void ReadPtr(T*& PtrRef, bool AllowBackpatch = true) {
266 ReadUIntPtr(reinterpret_cast<uintptr_t&>(PtrRef), AllowBackpatch);
269 template <typename T>
270 void ReadPtr(const T*& PtrRef, bool AllowBackpatch = true) {
271 ReadPtr(const_cast<T*&>(PtrRef), AllowBackpatch);
275 template <typename T>
276 void ReadPtr(T*& PtrRef, const SerializedPtrID& PtrID, bool AllowBackpatch = true) {
277 ReadUIntPtr(reinterpret_cast<uintptr_t&>(PtrRef), PtrID, AllowBackpatch);
280 template <typename T>
281 void ReadPtr(const T*& PtrRef, const SerializedPtrID& PtrID,
282 bool AllowBackpatch = true) {
284 ReadPtr(const_cast<T*&>(PtrRef), PtrID, AllowBackpatch);
287 template <typename T>
288 T* ReadPtr() { T* x; ReadPtr<T>(x,false); return x; }
290 void ReadUIntPtr(uintptr_t& PtrRef, const SerializedPtrID& PtrID,
291 bool AllowBackpatch = true);
293 void ReadUIntPtr(uintptr_t& PtrRef, bool AllowBackpatch = true) {
294 ReadUIntPtr(PtrRef,ReadPtrID(),AllowBackpatch);
297 template <typename T>
299 T* p = reinterpret_cast<T*>(ReadInternalRefPtr());
303 void RegisterPtr(const SerializedPtrID& PtrID, const void* Ptr);
305 void RegisterPtr(const void* Ptr) {
306 RegisterPtr(ReadPtrID(),Ptr);
310 void RegisterRef(const T& x) {
315 void RegisterRef(const SerializedPtrID& PtrID, const T& x) {
316 RegisterPtr(PtrID,&x);
319 Location getCurrentBlockLocation();
320 unsigned getCurrentBlockID();
321 unsigned getAbbrevNo();
323 bool FinishedBlock(Location BlockLoc);
324 bool JumpTo(const Location& BlockLoc);
325 void Rewind() { JumpTo(StreamStart); }
330 bool SkipToBlock(unsigned BlockID);
332 unsigned getRecordCode();
334 BitstreamReader& getStream() { return Stream; }
337 bool AdvanceStream();
340 uintptr_t ReadInternalRefPtr();
342 static inline bool HasFinalPtr(MapTy::value_type& V) {
343 return V.first.hasFinalPtr();
346 static inline uintptr_t GetFinalPtr(MapTy::value_type& V) {
347 return reinterpret_cast<uintptr_t>(V.second.Ptr);
350 static inline BPNode* GetBPNode(MapTy::value_type& V) {
351 return V.second.Head;
354 static inline void SetBPNode(MapTy::value_type& V, BPNode* N) {
358 void SetPtr(MapTy::value_type& V, const void* P) {
360 V.second.SetPtr(FreeList,const_cast<void*>(P));
364 } // end namespace llvm