1 //=- Deserialize.h - Generic Object Deserialization from Bitcode --*- C++ -*-=//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // 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 uint64_t StreamStart;
130 //===----------------------------------------------------------===//
132 //===----------------------------------------------------------===//
135 Deserializer(BitstreamReader& stream);
140 SerializedPtrID ReadPtrID() { return (SerializedPtrID) ReadInt(); }
144 return ReadInt() ? true : false;
147 template <typename T>
148 inline T& Read(T& X) {
149 SerializeTrait<T>::Read(*this,X);
153 template <typename T>
155 return SerializeTrait<T>::Create(*this);
158 char* ReadCStr(char* cstr = NULL, unsigned MaxLen=0, bool isNullTerm=true);
159 void ReadCStr(std::vector<char>& buff, bool isNullTerm=false, unsigned Idx=0);
161 template <typename T>
162 inline T* ReadOwnedPtr(bool AutoRegister = true) {
163 SerializedPtrID PtrID = ReadPtrID();
168 T* x = SerializeTrait<T>::Create(*this);
171 RegisterPtr(PtrID,x);
176 template <typename T>
177 inline void ReadOwnedPtr(T*& Ptr, bool AutoRegister = true) {
178 Ptr = ReadOwnedPtr<T>(AutoRegister);
181 template <typename T1, typename T2>
182 void BatchReadOwnedPtrs(T1*& P1, T2*& P2,
183 bool A1=true, bool A2=true) {
185 SerializedPtrID ID1 = ReadPtrID();
186 SerializedPtrID ID2 = ReadPtrID();
188 P1 = (ID1) ? SerializeTrait<T1>::Create(*this) : NULL;
189 if (ID1 && A1) RegisterPtr(ID1,P1);
191 P2 = (ID2) ? SerializeTrait<T2>::Create(*this) : NULL;
192 if (ID2 && A2) RegisterPtr(ID2,P2);
195 template <typename T1, typename T2, typename T3>
196 void BatchReadOwnedPtrs(T1*& P1, T2*& P2, T3*& P3,
197 bool A1=true, bool A2=true, bool A3=true) {
199 SerializedPtrID ID1 = ReadPtrID();
200 SerializedPtrID ID2 = ReadPtrID();
201 SerializedPtrID ID3 = ReadPtrID();
203 P1 = (ID1) ? SerializeTrait<T1>::Create(*this) : NULL;
204 if (ID1 && A1) RegisterPtr(ID1,P1);
206 P2 = (ID2) ? SerializeTrait<T2>::Create(*this) : NULL;
207 if (ID2 && A2) RegisterPtr(ID2,P2);
209 P3 = (ID3) ? SerializeTrait<T3>::Create(*this) : NULL;
210 if (ID3 && A3) RegisterPtr(ID3,P3);
213 template <typename T>
214 void BatchReadOwnedPtrs(unsigned NumPtrs, T** Ptrs, bool AutoRegister=true) {
215 llvm::SmallVector<SerializedPtrID,10> BatchIDVec;
217 for (unsigned i = 0; i < NumPtrs; ++i)
218 BatchIDVec.push_back(ReadPtrID());
220 for (unsigned i = 0; i < NumPtrs; ++i) {
221 SerializedPtrID& PtrID = BatchIDVec[i];
223 T* p = PtrID ? SerializeTrait<T>::Create(*this) : NULL;
225 if (PtrID && AutoRegister)
226 RegisterPtr(PtrID,p);
232 template <typename T1, typename T2>
233 void BatchReadOwnedPtrs(unsigned NumT1Ptrs, T1** Ptrs, T2*& P2,
234 bool A1=true, bool A2=true) {
236 llvm::SmallVector<SerializedPtrID,10> BatchIDVec;
238 for (unsigned i = 0; i < NumT1Ptrs; ++i)
239 BatchIDVec.push_back(ReadPtrID());
241 SerializedPtrID ID2 = ReadPtrID();
243 for (unsigned i = 0; i < NumT1Ptrs; ++i) {
244 SerializedPtrID& PtrID = BatchIDVec[i];
246 T1* p = PtrID ? SerializeTrait<T1>::Create(*this) : NULL;
249 RegisterPtr(PtrID,p);
254 P2 = (ID2) ? SerializeTrait<T2>::Create(*this) : NULL;
255 if (ID2 && A2) RegisterPtr(ID2,P2);
258 template <typename T1, typename T2, typename T3>
259 void BatchReadOwnedPtrs(unsigned NumT1Ptrs, T1** Ptrs,
261 bool A1=true, bool A2=true, bool A3=true) {
263 llvm::SmallVector<SerializedPtrID,10> BatchIDVec;
265 for (unsigned i = 0; i < NumT1Ptrs; ++i)
266 BatchIDVec.push_back(ReadPtrID());
268 SerializedPtrID ID2 = ReadPtrID();
269 SerializedPtrID ID3 = ReadPtrID();
271 for (unsigned i = 0; i < NumT1Ptrs; ++i) {
272 SerializedPtrID& PtrID = BatchIDVec[i];
274 T1* p = PtrID ? SerializeTrait<T1>::Create(*this) : NULL;
277 RegisterPtr(PtrID,p);
282 P2 = (ID2) ? SerializeTrait<T2>::Create(*this) : NULL;
283 if (ID2 && A2) RegisterPtr(ID2,P2);
285 P3 = (ID3) ? SerializeTrait<T3>::Create(*this) : NULL;
286 if (ID3 && A3) RegisterPtr(ID3,P3);
289 template <typename T>
290 void ReadPtr(T*& PtrRef, bool AllowBackpatch = true) {
291 ReadUIntPtr(reinterpret_cast<uintptr_t&>(PtrRef), AllowBackpatch);
294 template <typename T>
295 void ReadPtr(const T*& PtrRef, bool AllowBackpatch = true) {
296 ReadPtr(const_cast<T*&>(PtrRef), AllowBackpatch);
300 template <typename T>
301 void ReadPtr(T*& PtrRef, const SerializedPtrID& PtrID,
302 bool AllowBackpatch = true) {
303 ReadUIntPtr(reinterpret_cast<uintptr_t&>(PtrRef), PtrID, AllowBackpatch);
306 template <typename T>
307 void ReadPtr(const T*& PtrRef, const SerializedPtrID& PtrID,
308 bool AllowBackpatch = true) {
310 ReadPtr(const_cast<T*&>(PtrRef), PtrID, AllowBackpatch);
313 template <typename T>
314 T* ReadPtr() { T* x; ReadPtr<T>(x,false); return x; }
316 void ReadUIntPtr(uintptr_t& PtrRef, const SerializedPtrID& PtrID,
317 bool AllowBackpatch = true);
319 void ReadUIntPtr(uintptr_t& PtrRef, bool AllowBackpatch = true) {
320 ReadUIntPtr(PtrRef,ReadPtrID(),AllowBackpatch);
323 template <typename T>
325 T* p = reinterpret_cast<T*>(ReadInternalRefPtr());
329 void RegisterPtr(const SerializedPtrID& PtrID, const void* Ptr);
331 void RegisterPtr(const void* Ptr) {
332 RegisterPtr(ReadPtrID(),Ptr);
336 void RegisterRef(const T& x) {
341 void RegisterRef(const SerializedPtrID& PtrID, const T& x) {
342 RegisterPtr(PtrID,&x);
345 Location getCurrentBlockLocation();
346 unsigned getCurrentBlockID();
347 unsigned getAbbrevNo();
349 bool FinishedBlock(Location BlockLoc);
350 bool JumpTo(const Location& BlockLoc);
356 bool SkipToBlock(unsigned BlockID);
358 unsigned getRecordCode();
360 BitstreamReader& getStream() { return Stream; }
363 bool AdvanceStream();
366 uintptr_t ReadInternalRefPtr();
368 static inline bool HasFinalPtr(MapTy::value_type& V) {
369 return V.first.hasFinalPtr();
372 static inline uintptr_t GetFinalPtr(MapTy::value_type& V) {
373 return reinterpret_cast<uintptr_t>(V.second.Ptr);
376 static inline BPNode* GetBPNode(MapTy::value_type& V) {
377 return V.second.Head;
380 static inline void SetBPNode(MapTy::value_type& V, BPNode* N) {
384 void SetPtr(MapTy::value_type& V, const void* P) {
386 V.second.SetPtr(FreeList,const_cast<void*>(P));
390 } // end namespace llvm