clang  14.0.0git
BasicValueFactory.h
Go to the documentation of this file.
1 //==- BasicValueFactory.h - Basic values for Path Sens analysis --*- 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 // This file defines BasicValueFactory, a class that manages the lifetime
10 // of APSInt objects and symbolic constraints used by ExprEngine
11 // and related classes.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #ifndef LLVM_CLANG_STATICANALYZER_CORE_PATHSENSITIVE_BASICVALUEFACTORY_H
16 #define LLVM_CLANG_STATICANALYZER_CORE_PATHSENSITIVE_BASICVALUEFACTORY_H
17 
18 #include "clang/AST/ASTContext.h"
19 #include "clang/AST/Expr.h"
20 #include "clang/AST/Type.h"
25 #include "llvm/ADT/APSInt.h"
26 #include "llvm/ADT/FoldingSet.h"
27 #include "llvm/ADT/ImmutableList.h"
28 #include "llvm/ADT/iterator_range.h"
29 #include "llvm/Support/Allocator.h"
30 #include <cassert>
31 #include <cstdint>
32 #include <utility>
33 
34 namespace clang {
35 
36 class CXXBaseSpecifier;
37 class DeclaratorDecl;
38 
39 namespace ento {
40 
41 class CompoundValData : public llvm::FoldingSetNode {
42  QualType T;
43  llvm::ImmutableList<SVal> L;
44 
45 public:
46  CompoundValData(QualType t, llvm::ImmutableList<SVal> l) : T(t), L(l) {
47  assert(NonLoc::isCompoundType(t));
48  }
49 
50  using iterator = llvm::ImmutableList<SVal>::iterator;
51 
52  iterator begin() const { return L.begin(); }
53  iterator end() const { return L.end(); }
54 
55  QualType getType() const { return T; }
56 
57  static void Profile(llvm::FoldingSetNodeID& ID, QualType T,
58  llvm::ImmutableList<SVal> L);
59 
60  void Profile(llvm::FoldingSetNodeID& ID) { Profile(ID, T, L); }
61 };
62 
63 class LazyCompoundValData : public llvm::FoldingSetNode {
64  StoreRef store;
65  const TypedValueRegion *region;
66 
67 public:
69  : store(st), region(r) {
71  }
72 
73  const void *getStore() const { return store.getStore(); }
74  const TypedValueRegion *getRegion() const { return region; }
75 
76  static void Profile(llvm::FoldingSetNodeID& ID,
77  const StoreRef &store,
78  const TypedValueRegion *region);
79 
80  void Profile(llvm::FoldingSetNodeID& ID) { Profile(ID, store, region); }
81 };
82 
83 class PointerToMemberData : public llvm::FoldingSetNode {
84  const NamedDecl *D;
85  llvm::ImmutableList<const CXXBaseSpecifier *> L;
86 
87 public:
89  llvm::ImmutableList<const CXXBaseSpecifier *> L)
90  : D(D), L(L) {}
91 
92  using iterator = llvm::ImmutableList<const CXXBaseSpecifier *>::iterator;
93 
94  iterator begin() const { return L.begin(); }
95  iterator end() const { return L.end(); }
96 
97  static void Profile(llvm::FoldingSetNodeID &ID, const NamedDecl *D,
98  llvm::ImmutableList<const CXXBaseSpecifier *> L);
99 
100  void Profile(llvm::FoldingSetNodeID &ID) { Profile(ID, D, L); }
101  const NamedDecl *getDeclaratorDecl() const { return D; }
102 
103  llvm::ImmutableList<const CXXBaseSpecifier *> getCXXBaseList() const {
104  return L;
105  }
106 };
107 
109  using APSIntSetTy =
110  llvm::FoldingSet<llvm::FoldingSetNodeWrapper<llvm::APSInt>>;
111 
112  ASTContext &Ctx;
113  llvm::BumpPtrAllocator& BPAlloc;
114 
115  APSIntSetTy APSIntSet;
116  void *PersistentSVals = nullptr;
117  void *PersistentSValPairs = nullptr;
118 
119  llvm::ImmutableList<SVal>::Factory SValListFactory;
120  llvm::ImmutableList<const CXXBaseSpecifier *>::Factory CXXBaseListFactory;
121  llvm::FoldingSet<CompoundValData> CompoundValDataSet;
122  llvm::FoldingSet<LazyCompoundValData> LazyCompoundValDataSet;
123  llvm::FoldingSet<PointerToMemberData> PointerToMemberDataSet;
124 
125  // This is private because external clients should use the factory
126  // method that takes a QualType.
127  const llvm::APSInt& getValue(uint64_t X, unsigned BitWidth, bool isUnsigned);
128 
129 public:
130  BasicValueFactory(ASTContext &ctx, llvm::BumpPtrAllocator &Alloc)
131  : Ctx(ctx), BPAlloc(Alloc), SValListFactory(Alloc),
132  CXXBaseListFactory(Alloc) {}
133 
135 
136  ASTContext &getContext() const { return Ctx; }
137 
138  const llvm::APSInt& getValue(const llvm::APSInt& X);
139  const llvm::APSInt& getValue(const llvm::APInt& X, bool isUnsigned);
140  const llvm::APSInt& getValue(uint64_t X, QualType T);
141 
142  /// Returns the type of the APSInt used to store values of the given QualType.
144  // For the purposes of the analysis and constraints, we treat atomics
145  // as their underlying types.
146  if (const AtomicType *AT = T->getAs<AtomicType>()) {
147  T = AT->getValueType();
148  }
149 
150  assert(T->isIntegralOrEnumerationType() || Loc::isLocType(T));
151  return APSIntType(Ctx.getIntWidth(T),
153  }
154 
155  /// Convert - Create a new persistent APSInt with the same value as 'From'
156  /// but with the bitwidth and signedness of 'To'.
158  const llvm::APSInt& From) {
159  APSIntType TargetType(To);
160  if (TargetType == APSIntType(From))
161  return From;
162 
163  return getValue(TargetType.convert(From));
164  }
165 
166  const llvm::APSInt &Convert(QualType T, const llvm::APSInt &From) {
167  APSIntType TargetType = getAPSIntType(T);
168  return Convert(TargetType, From);
169  }
170 
171  const llvm::APSInt &Convert(APSIntType TargetType, const llvm::APSInt &From) {
172  if (TargetType == APSIntType(From))
173  return From;
174 
175  return getValue(TargetType.convert(From));
176  }
177 
178  const llvm::APSInt &getIntValue(uint64_t X, bool isUnsigned) {
179  QualType T = isUnsigned ? Ctx.UnsignedIntTy : Ctx.IntTy;
180  return getValue(X, T);
181  }
182 
184  return getValue(APSIntType(v).getMaxValue());
185  }
186 
188  return getValue(APSIntType(v).getMinValue());
189  }
190 
192  return getMaxValue(getAPSIntType(T));
193  }
194 
196  return getMinValue(getAPSIntType(T));
197  }
198 
200  return getValue(T.getMaxValue());
201  }
202 
204  return getValue(T.getMinValue());
205  }
206 
207  const llvm::APSInt &Add1(const llvm::APSInt &V) {
208  llvm::APSInt X = V;
209  ++X;
210  return getValue(X);
211  }
212 
213  const llvm::APSInt &Sub1(const llvm::APSInt &V) {
214  llvm::APSInt X = V;
215  --X;
216  return getValue(X);
217  }
218 
220  assert(T->isScalarType());
221  return getValue(0, Ctx.getTypeSize(T), true);
222  }
223 
224  const llvm::APSInt &getZeroWithPtrWidth(bool isUnsigned = true) {
225  return getValue(0, Ctx.getTypeSize(Ctx.VoidPtrTy), isUnsigned);
226  }
227 
228  const llvm::APSInt &getIntWithPtrWidth(uint64_t X, bool isUnsigned) {
229  return getValue(X, Ctx.getTypeSize(Ctx.VoidPtrTy), isUnsigned);
230  }
231 
233  return getValue(b ? 1 : 0, Ctx.getIntWidth(T),
235  }
236 
237  const llvm::APSInt &getTruthValue(bool b) {
238  return getTruthValue(b, Ctx.getLogicalOperationType());
239  }
240 
242  llvm::ImmutableList<SVal> Vals);
243 
245  const TypedValueRegion *region);
246 
247  const PointerToMemberData *
249  llvm::ImmutableList<const CXXBaseSpecifier *> L);
250 
251  llvm::ImmutableList<SVal> getEmptySValList() {
252  return SValListFactory.getEmptyList();
253  }
254 
255  llvm::ImmutableList<SVal> prependSVal(SVal X, llvm::ImmutableList<SVal> L) {
256  return SValListFactory.add(X, L);
257  }
258 
259  llvm::ImmutableList<const CXXBaseSpecifier *> getEmptyCXXBaseList() {
260  return CXXBaseListFactory.getEmptyList();
261  }
262 
263  llvm::ImmutableList<const CXXBaseSpecifier *> prependCXXBase(
264  const CXXBaseSpecifier *CBS,
265  llvm::ImmutableList<const CXXBaseSpecifier *> L) {
266  return CXXBaseListFactory.add(CBS, L);
267  }
268 
269  const PointerToMemberData *
270  accumCXXBase(llvm::iterator_range<CastExpr::path_const_iterator> PathRange,
271  const nonloc::PointerToMember &PTM, const clang::CastKind &kind);
272 
274  const llvm::APSInt& V1,
275  const llvm::APSInt& V2);
276 
277  const std::pair<SVal, uintptr_t>&
279 
280  const std::pair<SVal, SVal>&
281  getPersistentSValPair(const SVal& V1, const SVal& V2);
282 
283  const SVal* getPersistentSVal(SVal X);
284 };
285 
286 } // namespace ento
287 
288 } // namespace clang
289 
290 #endif // LLVM_CLANG_STATICANALYZER_CORE_PATHSENSITIVE_BASICVALUEFACTORY_H
clang::ento::BasicValueFactory::getPersistentSValWithData
const std::pair< SVal, uintptr_t > & getPersistentSValWithData(const SVal &V, uintptr_t Data)
Definition: BasicValueFactory.cpp:345
clang::ento::BasicValueFactory::getTruthValue
const llvm::APSInt & getTruthValue(bool b)
Definition: BasicValueFactory.h:237
clang::ento::BasicValueFactory::~BasicValueFactory
~BasicValueFactory()
Definition: BasicValueFactory.cpp:79
clang::ento::Loc::isLocType
static bool isLocType(QualType T)
Definition: SVals.h:336
clang::ento::BasicValueFactory::getEmptySValList
llvm::ImmutableList< SVal > getEmptySValList()
Definition: BasicValueFactory.h:251
clang::interp::APInt
llvm::APInt APInt
Definition: Integral.h:27
clang::ento::BasicValueFactory
Definition: BasicValueFactory.h:108
clang::ento::LazyCompoundValData
Definition: BasicValueFactory.h:63
clang::ento::BasicValueFactory::prependCXXBase
llvm::ImmutableList< const CXXBaseSpecifier * > prependCXXBase(const CXXBaseSpecifier *CBS, llvm::ImmutableList< const CXXBaseSpecifier * > L)
Definition: BasicValueFactory.h:263
clang::ento::CompoundValData
Definition: BasicValueFactory.h:41
SVals.h
clang::ento::BasicValueFactory::Add1
const llvm::APSInt & Add1(const llvm::APSInt &V)
Definition: BasicValueFactory.h:207
clang::ento::BasicValueFactory::getMaxValue
const llvm::APSInt & getMaxValue(const llvm::APSInt &v)
Definition: BasicValueFactory.h:183
clang::ASTContext::getIntWidth
unsigned getIntWidth(QualType T) const
Definition: ASTContext.cpp:10220
clang::NamedDecl
This represents a decl that may have a name.
Definition: Decl.h:249
clang::QualType
A (possibly-)qualified type.
Definition: Type.h:673
clang::ento::PointerToMemberData::begin
iterator begin() const
Definition: BasicValueFactory.h:94
clang::Type::isScalarType
bool isScalarType() const
Definition: Type.h:7042
clang::ento::BasicValueFactory::Convert
const llvm::APSInt & Convert(APSIntType TargetType, const llvm::APSInt &From)
Definition: BasicValueFactory.h:171
clang::ento::BasicValueFactory::getMinValue
const llvm::APSInt & getMinValue(APSIntType T)
Definition: BasicValueFactory.h:203
clang::ento::CompoundValData::Profile
void Profile(llvm::FoldingSetNodeID &ID)
Definition: BasicValueFactory.h:60
clang::ento::BasicValueFactory::getPersistentSVal
const SVal * getPersistentSVal(SVal X)
Definition: BasicValueFactory.cpp:394
clang::ento::PointerToMemberData::getDeclaratorDecl
const NamedDecl * getDeclaratorDecl() const
Definition: BasicValueFactory.h:101
clang::tooling::X
static ToolExecutorPluginRegistry::Add< AllTUsToolExecutorPlugin > X("all-TUs", "Runs FrontendActions on all TUs in the compilation database. " "Tool results are stored in memory.")
clang::ento::BasicValueFactory::getCompoundValData
const CompoundValData * getCompoundValData(QualType T, llvm::ImmutableList< SVal > Vals)
Definition: BasicValueFactory.cpp:126
clang::ento::PointerToMemberData::Profile
static void Profile(llvm::FoldingSetNodeID &ID, const NamedDecl *D, llvm::ImmutableList< const CXXBaseSpecifier * > L)
Definition: BasicValueFactory.cpp:45
clang::ento::BasicValueFactory::getPointerToMemberData
const PointerToMemberData * getPointerToMemberData(const NamedDecl *ND, llvm::ImmutableList< const CXXBaseSpecifier * > L)
Definition: BasicValueFactory.cpp:162
b
__device__ __2f16 b
Definition: __clang_hip_libdevice_declares.h:314
clang::ento::APSIntType::getMaxValue
llvm::APSInt getMaxValue() const LLVM_READONLY
Returns the maximum value for this type.
Definition: APSIntType.h:65
clang::ento::BasicValueFactory::accumCXXBase
const PointerToMemberData * accumCXXBase(llvm::iterator_range< CastExpr::path_const_iterator > PathRange, const nonloc::PointerToMember &PTM, const clang::CastKind &kind)
Definition: BasicValueFactory.cpp:192
clang::ento::BasicValueFactory::getMinValue
const llvm::APSInt & getMinValue(QualType T)
Definition: BasicValueFactory.h:195
APSInt
llvm::APSInt APSInt
Definition: ByteCodeEmitter.cpp:19
clang::ento::LazyCompoundValData::LazyCompoundValData
LazyCompoundValData(const StoreRef &st, const TypedValueRegion *r)
Definition: BasicValueFactory.h:68
V
#define V(N, I)
Definition: ASTContext.h:3121
clang::ento::StoreRef::getStore
Store getStore() const
Definition: StoreRef.h:46
clang::ento::NonLoc::isCompoundType
static bool isCompoundType(QualType T)
Definition: SVals.h:314
clang::Type::isSignedIntegerOrEnumerationType
bool isSignedIntegerOrEnumerationType() const
Determines whether this is an integer type that is signed or an enumeration types whose underlying ty...
Definition: Type.cpp:2032
clang::ento::BasicValueFactory::Convert
const llvm::APSInt & Convert(const llvm::APSInt &To, const llvm::APSInt &From)
Convert - Create a new persistent APSInt with the same value as 'From' but with the bitwidth and sign...
Definition: BasicValueFactory.h:157
clang::ento::PointerToMemberData::PointerToMemberData
PointerToMemberData(const NamedDecl *D, llvm::ImmutableList< const CXXBaseSpecifier * > L)
Definition: BasicValueFactory.h:88
clang::ASTContext
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:212
clang::ento::StoreRef
Definition: StoreRef.h:29
clang::Type::getAs
const T * getAs() const
Member-template getAs<specific type>'.
Definition: Type.h:7161
clang::ento::nonloc::PointerToMember
Value representing pointer-to-member.
Definition: SVals.h:532
clang::ASTContext::getTypeSize
uint64_t getTypeSize(QualType T) const
Return the size of the specified (complete) type T, in bits.
Definition: ASTContext.h:2245
uintptr_t
__UINTPTR_TYPE__ uintptr_t
An unsigned integer type with the property that any valid pointer to void can be converted to this ty...
Definition: opencl-c-base.h:124
Type.h
Expr.h
clang::ento::BasicValueFactory::prependSVal
llvm::ImmutableList< SVal > prependSVal(SVal X, llvm::ImmutableList< SVal > L)
Definition: BasicValueFactory.h:255
ASTContext.h
clang::Type::isUnsignedIntegerOrEnumerationType
bool isUnsignedIntegerOrEnumerationType() const
Determines whether this is an integer type that is unsigned or an enumeration types whose underlying ...
Definition: Type.cpp:2079
clang::ento::BasicValueFactory::getIntValue
const llvm::APSInt & getIntValue(uint64_t X, bool isUnsigned)
Definition: BasicValueFactory.h:178
clang::ento::CompoundValData::Profile
static void Profile(llvm::FoldingSetNodeID &ID, QualType T, llvm::ImmutableList< SVal > L)
Definition: BasicValueFactory.cpp:32
clang::ento::APSIntType
A record of the "type" of an APSInt, used for conversions.
Definition: APSIntType.h:19
clang::ento::LazyCompoundValData::getRegion
const TypedValueRegion * getRegion() const
Definition: BasicValueFactory.h:74
clang::ento::BasicValueFactory::getIntWithPtrWidth
const llvm::APSInt & getIntWithPtrWidth(uint64_t X, bool isUnsigned)
Definition: BasicValueFactory.h:228
clang::ento::LazyCompoundValData::Profile
static void Profile(llvm::FoldingSetNodeID &ID, const StoreRef &store, const TypedValueRegion *region)
Definition: BasicValueFactory.cpp:38
clang::ento::BasicValueFactory::getContext
ASTContext & getContext() const
Definition: BasicValueFactory.h:136
clang::ento::APSIntType::getMinValue
llvm::APSInt getMinValue() const LLVM_READONLY
Returns the minimum value for this type.
Definition: APSIntType.h:60
clang::ento::BasicValueFactory::getMaxValue
const llvm::APSInt & getMaxValue(APSIntType T)
Definition: BasicValueFactory.h:199
clang::ASTContext::getLogicalOperationType
QualType getLogicalOperationType() const
The result type of logical operations, '<', '>', '!=', etc.
Definition: ASTContext.h:1929
clang::ento::PointerToMemberData::iterator
llvm::ImmutableList< const CXXBaseSpecifier * >::iterator iterator
Definition: BasicValueFactory.h:92
clang::ASTContext::UnsignedIntTy
CanQualType UnsignedIntTy
Definition: ASTContext.h:1085
clang::ASTContext::VoidPtrTy
CanQualType VoidPtrTy
Definition: ASTContext.h:1102
clang::ento::LazyCompoundValData::getStore
const void * getStore() const
Definition: BasicValueFactory.h:73
clang::ento::CompoundValData::getType
QualType getType() const
Definition: BasicValueFactory.h:55
clang::ASTContext::IntTy
CanQualType IntTy
Definition: ASTContext.h:1084
clang::ento::BasicValueFactory::getEmptyCXXBaseList
llvm::ImmutableList< const CXXBaseSpecifier * > getEmptyCXXBaseList()
Definition: BasicValueFactory.h:259
clang::ento::BasicValueFactory::BasicValueFactory
BasicValueFactory(ASTContext &ctx, llvm::BumpPtrAllocator &Alloc)
Definition: BasicValueFactory.h:130
clang::ento::BasicValueFactory::getLazyCompoundValData
const LazyCompoundValData * getLazyCompoundValData(const StoreRef &store, const TypedValueRegion *region)
Definition: BasicValueFactory.cpp:144
APSIntType.h
clang::BinaryOperatorKind
BinaryOperatorKind
Definition: OperationKinds.h:25
clang::ento::BasicValueFactory::getMinValue
const llvm::APSInt & getMinValue(const llvm::APSInt &v)
Definition: BasicValueFactory.h:187
clang::ento::BasicValueFactory::getZeroWithPtrWidth
const llvm::APSInt & getZeroWithPtrWidth(bool isUnsigned=true)
Definition: BasicValueFactory.h:224
clang::ento::TypedValueRegion::getValueType
virtual QualType getValueType() const =0
clang::Builtin::ID
ID
Definition: Builtins.h:48
clang
Definition: CalledOnceCheck.h:17
clang::ento::CompoundValData::begin
iterator begin() const
Definition: BasicValueFactory.h:52
clang::ento::PointerToMemberData::getCXXBaseList
llvm::ImmutableList< const CXXBaseSpecifier * > getCXXBaseList() const
Definition: BasicValueFactory.h:103
clang::ento::BasicValueFactory::Sub1
const llvm::APSInt & Sub1(const llvm::APSInt &V)
Definition: BasicValueFactory.h:213
clang::ento::CompoundValData::CompoundValData
CompoundValData(QualType t, llvm::ImmutableList< SVal > l)
Definition: BasicValueFactory.h:46
clang::ento::PointerToMemberData::end
iterator end() const
Definition: BasicValueFactory.h:95
MemRegion.h
clang::CXXBaseSpecifier
Represents a base class of a C++ class.
Definition: DeclCXX.h:147
clang::ento::BasicValueFactory::evalAPSInt
const llvm::APSInt * evalAPSInt(BinaryOperator::Opcode Op, const llvm::APSInt &V1, const llvm::APSInt &V2)
Definition: BasicValueFactory.cpp:250
clang::ento::APSIntType::convert
llvm::APSInt convert(const llvm::APSInt &Value) const LLVM_READONLY
Convert and return a new APSInt with the given value, but this type's bit width and signedness.
Definition: APSIntType.h:48
clang::ento::LazyCompoundValData::Profile
void Profile(llvm::FoldingSetNodeID &ID)
Definition: BasicValueFactory.h:80
clang::ento::BasicValueFactory::Convert
const llvm::APSInt & Convert(QualType T, const llvm::APSInt &From)
Definition: BasicValueFactory.h:166
clang::ento::PointerToMemberData
Definition: BasicValueFactory.h:83
clang::ento::SVal
SVal - This represents a symbolic expression, which can be either an L-value or an R-value.
Definition: SVals.h:75
v
do v
Definition: arm_acle.h:76
clang::ento::TypedValueRegion
TypedValueRegion - An abstract class representing regions having a typed value.
Definition: MemRegion.h:522
clang::AtomicType
Definition: Type.h:6242
clang::ento::BasicValueFactory::getMaxValue
const llvm::APSInt & getMaxValue(QualType T)
Definition: BasicValueFactory.h:191
clang::CastKind
CastKind
CastKind - The kind of operation required for a conversion.
Definition: OperationKinds.h:20
clang::ento::CompoundValData::iterator
llvm::ImmutableList< SVal >::iterator iterator
Definition: BasicValueFactory.h:50
StoreRef.h
clang::diag::kind
unsigned kind
All of the diagnostics that can be emitted by the frontend.
Definition: DiagnosticIDs.h:62
clang::ento::CompoundValData::end
iterator end() const
Definition: BasicValueFactory.h:53
clang::ento::BasicValueFactory::getAPSIntType
APSIntType getAPSIntType(QualType T) const
Returns the type of the APSInt used to store values of the given QualType.
Definition: BasicValueFactory.h:143
clang::ento::BasicValueFactory::getZeroWithTypeSize
const llvm::APSInt & getZeroWithTypeSize(QualType T)
Definition: BasicValueFactory.h:219
clang::Type::isIntegralOrEnumerationType
bool isIntegralOrEnumerationType() const
Determine whether this type is an integral or enumeration type.
Definition: Type.h:7058
clang::ento::BasicValueFactory::getTruthValue
const llvm::APSInt & getTruthValue(bool b, QualType T)
Definition: BasicValueFactory.h:232
clang::ento::PointerToMemberData::Profile
void Profile(llvm::FoldingSetNodeID &ID)
Definition: BasicValueFactory.h:100
clang::ento::BasicValueFactory::getPersistentSValPair
const std::pair< SVal, SVal > & getPersistentSValPair(const SVal &V1, const SVal &V2)
Definition: BasicValueFactory.cpp:370