#include "clang/StaticAnalyzer/Core/PathSensitive/MemRegion.h"

Public Member Functions
	MemRegionManager (ASTContext &c, llvm::BumpPtrAllocator &a)

	~MemRegionManager ()

ASTContext &	getContext ()

const ASTContext &	getContext () const

llvm::BumpPtrAllocator &	getAllocator ()

DefinedOrUnknownSVal	getStaticSize (const MemRegion *MR, SValBuilder &SVB) const

const StackLocalsSpaceRegion *	getStackLocalsRegion (const StackFrameContext *STC)
	getStackLocalsRegion - Retrieve the memory region associated with the specified stack frame.

const StackArgumentsSpaceRegion *	getStackArgumentsRegion (const StackFrameContext *STC)
	getStackArgumentsRegion - Retrieve the memory region associated with function/method arguments of the specified stack frame.

const GlobalsSpaceRegion *	getGlobalsRegion (MemRegion::Kind K=MemRegion::GlobalInternalSpaceRegionKind, const CodeTextRegion *R=nullptr)
	getGlobalsRegion - Retrieve the memory region associated with global variables.

const HeapSpaceRegion *	getHeapRegion ()
	getHeapRegion - Retrieve the memory region associated with the generic "heap".

const UnknownSpaceRegion *	getUnknownRegion ()
	getUnknownRegion - Retrieve the memory region associated with unknown memory space.

const CodeSpaceRegion *	getCodeRegion ()

const AllocaRegion *	getAllocaRegion (const Expr Ex, unsigned Cnt, const LocationContext LC)
	getAllocaRegion - Retrieve a region associated with a call to alloca().

const CompoundLiteralRegion *	getCompoundLiteralRegion (const CompoundLiteralExpr CL, const LocationContext LC)
	getCompoundLiteralRegion - Retrieve the region associated with a given CompoundLiteral.

const CXXThisRegion *	getCXXThisRegion (QualType thisPointerTy, const LocationContext *LC)
	getCXXThisRegion - Retrieve the [artificial] region associated with the parameter 'this'.

const SymbolicRegion *	getSymbolicRegion (SymbolRef Sym, const MemSpaceRegion *MemSpace=nullptr)
	Retrieve or create a "symbolic" memory region.

const SymbolicRegion *	getSymbolicHeapRegion (SymbolRef sym)
	Return a unique symbolic region belonging to heap memory space.

const StringRegion *	getStringRegion (const StringLiteral *Str)

const ObjCStringRegion *	getObjCStringRegion (const ObjCStringLiteral *Str)

const VarRegion *	getVarRegion (const VarDecl VD, const LocationContext LC)
	getVarRegion - Retrieve or create the memory region associated with a specified VarDecl and LocationContext.

const NonParamVarRegion *	getNonParamVarRegion (const VarDecl VD, const MemRegion superR)
	getVarRegion - Retrieve or create the memory region associated with a specified VarDecl and LocationContext.

const ParamVarRegion *	getParamVarRegion (const Expr OriginExpr, unsigned Index, const LocationContext LC)
	getParamVarRegion - Retrieve or create the memory region associated with a specified CallExpr, Index and LocationContext.

const ElementRegion *	getElementRegion (QualType elementType, NonLoc Idx, const SubRegion *superRegion, const ASTContext &Ctx)
	getElementRegion - Retrieve the memory region associated with the associated element type, index, and super region.

const ElementRegion *	getElementRegionWithSuper (const ElementRegion ER, const SubRegion superRegion)

const FieldRegion *	getFieldRegion (const FieldDecl fd, const SubRegion superRegion)
	getFieldRegion - Retrieve or create the memory region associated with a specified FieldDecl.

const FieldRegion *	getFieldRegionWithSuper (const FieldRegion FR, const SubRegion superRegion)

const ObjCIvarRegion *	getObjCIvarRegion (const ObjCIvarDecl ivd, const SubRegion superRegion)
	getObjCIvarRegion - Retrieve or create the memory region associated with a specified Objective-c instance variable.

const CXXTempObjectRegion *	getCXXTempObjectRegion (Expr const Ex, LocationContext const LC)

const CXXLifetimeExtendedObjectRegion *	getCXXLifetimeExtendedObjectRegion (Expr const Ex, ValueDecl const VD, LocationContext const *LC)
	Create a CXXLifetimeExtendedObjectRegion for temporaries which are lifetime-extended by local references.

const CXXLifetimeExtendedObjectRegion *	getCXXStaticLifetimeExtendedObjectRegion (const Expr Ex, ValueDecl const VD)
	Create a CXXLifetimeExtendedObjectRegion for temporaries which are lifetime-extended by static references.

const CXXBaseObjectRegion *	getCXXBaseObjectRegion (const CXXRecordDecl BaseClass, const SubRegion Super, bool IsVirtual)
	Create a CXXBaseObjectRegion with the given base class for region `Super`.

const CXXBaseObjectRegion *	getCXXBaseObjectRegionWithSuper (const CXXBaseObjectRegion baseReg, const SubRegion superRegion)
	Create a CXXBaseObjectRegion with the same CXXRecordDecl but a different super region.

const CXXDerivedObjectRegion *	getCXXDerivedObjectRegion (const CXXRecordDecl BaseClass, const SubRegion Super)
	Create a CXXDerivedObjectRegion with the given derived class for region `Super`.

const FunctionCodeRegion *	getFunctionCodeRegion (const NamedDecl *FD)

const BlockCodeRegion *	getBlockCodeRegion (const BlockDecl BD, CanQualType locTy, AnalysisDeclContext AC)

const BlockDataRegion *	getBlockDataRegion (const BlockCodeRegion bc, const LocationContext lc, unsigned blockCount)
	getBlockDataRegion - Get the memory region associated with an instance of a block.

Detailed Description

Definition at line 1404 of file MemRegion.h.

Constructor & Destructor Documentation

◆ MemRegionManager()

clang::ento::MemRegionManager::MemRegionManager	(	ASTContext &	c,
		llvm::BumpPtrAllocator &	a
	)

inline

Definition at line 1426 of file MemRegion.h.

◆ ~MemRegionManager()

MemRegionManager::~MemRegionManager ( )

default

Member Function Documentation

◆ getAllocaRegion()

const AllocaRegion * MemRegionManager::getAllocaRegion	(	const Expr *	Ex,
		unsigned	Cnt,
		const LocationContext *	LC
	)

getAllocaRegion - Retrieve a region associated with a call to alloca().

Definition at line 1344 of file MemRegion.cpp.

References E, clang::LocationContext::getStackFrame(), and getStackLocalsRegion().

Referenced by clang::ento::SValBuilder::getAllocaRegionVal().

◆ getAllocator()

llvm::BumpPtrAllocator & clang::ento::MemRegionManager::getAllocator ( )

inline

Definition at line 1432 of file MemRegion.h.

◆ getBlockCodeRegion()

const BlockCodeRegion * MemRegionManager::getBlockCodeRegion	(	const BlockDecl *	BD,
		CanQualType	locTy,
		AnalysisDeclContext *	AC
	)

Definition at line 1220 of file MemRegion.cpp.

References getCodeRegion().

Referenced by clang::ento::SValBuilder::getBlockPointer(), and getVarRegion().

◆ getBlockDataRegion()

const BlockDataRegion * MemRegionManager::getBlockDataRegion	(	const BlockCodeRegion *	bc,
		const LocationContext *	lc,
		unsigned	blockCount
	)

getBlockDataRegion - Get the memory region associated with an instance of a block.

Unlike many other MemRegions, the LocationContext* argument is allowed to be NULL for cases where we have no known context.

Definition at line 1145 of file MemRegion.cpp.

References clang::ento::BlockCodeRegion::getDecl(), getGlobalsRegion(), clang::ASTContext::getLangOpts(), clang::LocationContext::getStackFrame(), getStackLocalsRegion(), getUnknownRegion(), and clang::BlockDecl::hasCaptures().

Referenced by clang::ento::SValBuilder::getBlockPointer().

◆ getCodeRegion()

const CodeSpaceRegion * MemRegionManager::getCodeRegion ( )

Definition at line 977 of file MemRegion.cpp.

Referenced by getBlockCodeRegion(), and getFunctionCodeRegion().

◆ getCompoundLiteralRegion()

const CompoundLiteralRegion * MemRegionManager::getCompoundLiteralRegion	(	const CompoundLiteralExpr *	CL,
		const LocationContext *	LC
	)

getCompoundLiteralRegion - Retrieve the region associated with a given CompoundLiteral.

Definition at line 1177 of file MemRegion.cpp.

References getGlobalsRegion(), clang::LocationContext::getStackFrame(), getStackLocalsRegion(), and clang::CompoundLiteralExpr::isFileScope().

Referenced by clang::ento::StoreManager::getLValueCompoundLiteral().

◆ getContext() [1/2]

ASTContext & clang::ento::MemRegionManager::getContext ( )

inline

Definition at line 1429 of file MemRegion.h.

Referenced by clang::ento::MemRegion::getContext(), and getVarRegion().

◆ getContext() [2/2]

const ASTContext & clang::ento::MemRegionManager::getContext ( ) const

inline

Definition at line 1430 of file MemRegion.h.

◆ getCXXBaseObjectRegion()

const CXXBaseObjectRegion * MemRegionManager::getCXXBaseObjectRegion	(	const CXXRecordDecl *	BaseClass,
		const SubRegion *	Super,
		bool	IsVirtual
	)

Create a CXXBaseObjectRegion with the given base class for region Super.

The type of Super is assumed be a class deriving from BaseClass.

Definition at line 1297 of file MemRegion.cpp.

References isValidBaseClass().

Referenced by clang::ento::ExprEngine::computeObjectUnderConstruction(), clang::ento::StoreManager::evalDerivedToBase(), and getCXXBaseObjectRegionWithSuper().

◆ getCXXBaseObjectRegionWithSuper()

const CXXBaseObjectRegion * clang::ento::MemRegionManager::getCXXBaseObjectRegionWithSuper	(	const CXXBaseObjectRegion *	baseReg,
		const SubRegion *	superRegion
	)

inline

Create a CXXBaseObjectRegion with the same CXXRecordDecl but a different super region.

Definition at line 1565 of file MemRegion.h.

References getCXXBaseObjectRegion(), clang::ento::CXXBaseObjectRegion::getDecl(), and clang::ento::CXXBaseObjectRegion::isVirtual().

◆ getCXXDerivedObjectRegion()

const CXXDerivedObjectRegion * MemRegionManager::getCXXDerivedObjectRegion	(	const CXXRecordDecl *	BaseClass,
		const SubRegion *	Super
	)

Create a CXXDerivedObjectRegion with the given derived class for region Super.

This should not be used for casting an existing CXXBaseObjectRegion back to the derived type; instead, CXXBaseObjectRegion should be removed.

Definition at line 1317 of file MemRegion.cpp.

Referenced by clang::ento::StoreManager::evalBaseToDerived().

◆ getCXXLifetimeExtendedObjectRegion()

const CXXLifetimeExtendedObjectRegion * MemRegionManager::getCXXLifetimeExtendedObjectRegion	(	Expr const *	Ex,
		ValueDecl const *	VD,
		LocationContext const *	LC
	)

Create a CXXLifetimeExtendedObjectRegion for temporaries which are lifetime-extended by local references.

Definition at line 1258 of file MemRegion.cpp.

References clang::LocationContext::getStackFrame(), and getStackLocalsRegion().

Referenced by clang::ento::ExprEngine::computeObjectUnderConstruction().

◆ getCXXStaticLifetimeExtendedObjectRegion()

const CXXLifetimeExtendedObjectRegion * MemRegionManager::getCXXStaticLifetimeExtendedObjectRegion	(	const Expr *	Ex,
		ValueDecl const *	VD
	)

Create a CXXLifetimeExtendedObjectRegion for temporaries which are lifetime-extended by static references.

This differs from getCXXLifetimeExtendedObjectRegion(Expr const *, ValueDecl const *, LocationContext const *) in the super-region used.

Definition at line 1267 of file MemRegion.cpp.

References getGlobalsRegion().

Referenced by clang::ento::ExprEngine::computeObjectUnderConstruction().

◆ getCXXTempObjectRegion()

const CXXTempObjectRegion * MemRegionManager::getCXXTempObjectRegion	(	Expr const *	Ex,
		LocationContext const *	LC
	)

Definition at line 1250 of file MemRegion.cpp.

References E, clang::LocationContext::getStackFrame(), and getStackLocalsRegion().

Referenced by clang::ento::ExprEngine::computeObjectUnderConstruction(), clang::ento::ExprEngine::VisitCXXDestructor(), and clang::ento::ExprEngine::VisitLambdaExpr().

◆ getCXXThisRegion()

const CXXThisRegion * MemRegionManager::getCXXThisRegion	(	QualType	thisPointerTy,
		const LocationContext *	LC
	)

getCXXThisRegion - Retrieve the [artificial] region associated with the parameter 'this'.

Definition at line 1323 of file MemRegion.cpp.

References D, clang::Type::getAs(), clang::LocationContext::getDecl(), clang::LocationContext::getParent(), getStackArgumentsRegion(), clang::LocationContext::getStackFrame(), and clang::LocationContext::inTopFrame().

Referenced by clang::ento::getWidenedLoopState(), and clang::ento::ExprEngine::VisitCXXThisExpr().

◆ getElementRegion()

const ElementRegion * MemRegionManager::getElementRegion	(	QualType	elementType,
		NonLoc	Idx,
		const SubRegion *	superRegion,
		const ASTContext &	Ctx
	)

getElementRegion - Retrieve the memory region associated with the associated element type, index, and super region.

Definition at line 1193 of file MemRegion.cpp.

References clang::ASTContext::getCanonicalType(), clang::CanQual< T >::getUnqualifiedType(), and clang::T.

Referenced by bindRequiredArrayElementToEnvironment(), clang::ento::ExprEngine::computeObjectUnderConstruction(),

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ MemRegionManager()

◆ ~MemRegionManager()

Member Function Documentation

◆ getAllocaRegion()

◆ getAllocator()

◆ getBlockCodeRegion()

◆ getBlockDataRegion()

◆ getCodeRegion()

◆ getCompoundLiteralRegion()

◆ getContext() [1/2]

◆ getContext() [2/2]

◆ getCXXBaseObjectRegion()

◆ getCXXBaseObjectRegionWithSuper()

◆ getCXXDerivedObjectRegion()

◆ getCXXLifetimeExtendedObjectRegion()

◆ getCXXStaticLifetimeExtendedObjectRegion()

◆ getCXXTempObjectRegion()

◆ getCXXThisRegion()

◆ getElementRegion()