clang  3.7.0
Public Types | Public Member Functions | Static Public Member Functions | Friends | List of all members
clang::CXXNewExpr Class Reference

Represents a new-expression for memory allocation and constructor calls, e.g: "new CXXNewExpr(foo)". More...

#include <ExprCXX.h>

Inheritance diagram for clang::CXXNewExpr:
[legend]
Collaboration diagram for clang::CXXNewExpr:
[legend]

Public Types

enum  InitializationStyle { NoInit, CallInit, ListInit }
 
typedef ExprIterator arg_iterator
 
typedef ConstExprIterator const_arg_iterator
 
typedef Stmt ** raw_arg_iterator
 
- Public Types inherited from clang::Expr
enum  LValueClassification {
  LV_Valid, LV_NotObjectType, LV_IncompleteVoidType, LV_DuplicateVectorComponents,
  LV_InvalidExpression, LV_InvalidMessageExpression, LV_MemberFunction, LV_SubObjCPropertySetting,
  LV_ClassTemporary, LV_ArrayTemporary
}
 
enum  isModifiableLvalueResult {
  MLV_Valid, MLV_NotObjectType, MLV_IncompleteVoidType, MLV_DuplicateVectorComponents,
  MLV_InvalidExpression, MLV_LValueCast, MLV_IncompleteType, MLV_ConstQualified,
  MLV_ConstAddrSpace, MLV_ArrayType, MLV_NoSetterProperty, MLV_MemberFunction,
  MLV_SubObjCPropertySetting, MLV_InvalidMessageExpression, MLV_ClassTemporary, MLV_ArrayTemporary
}
 
enum  SideEffectsKind { SE_NoSideEffects, SE_AllowSideEffects }
 
enum  NullPointerConstantKind {
  NPCK_NotNull = 0, NPCK_ZeroExpression, NPCK_ZeroLiteral, NPCK_CXX11_nullptr,
  NPCK_GNUNull
}
 Enumeration used to describe the kind of Null pointer constant returned from isNullPointerConstant(). More...
 
enum  NullPointerConstantValueDependence { NPC_NeverValueDependent = 0, NPC_ValueDependentIsNull, NPC_ValueDependentIsNotNull }
 Enumeration used to describe how isNullPointerConstant() should cope with value-dependent expressions. More...
 

Public Member Functions

 CXXNewExpr (const ASTContext &C, bool globalNew, FunctionDecl *operatorNew, FunctionDecl *operatorDelete, bool usualArrayDeleteWantsSize, ArrayRef< Expr * > placementArgs, SourceRange typeIdParens, Expr *arraySize, InitializationStyle initializationStyle, Expr *initializer, QualType ty, TypeSourceInfo *AllocatedTypeInfo, SourceRange Range, SourceRange directInitRange)
 
 CXXNewExpr (EmptyShell Shell)
 
void AllocateArgsArray (const ASTContext &C, bool isArray, unsigned numPlaceArgs, bool hasInitializer)
 
QualType getAllocatedType () const
 
TypeSourceInfogetAllocatedTypeSourceInfo () const
 
bool shouldNullCheckAllocation (const ASTContext &Ctx) const
 True if the allocation result needs to be null-checked. More...
 
FunctionDeclgetOperatorNew () const
 
void setOperatorNew (FunctionDecl *D)
 
FunctionDeclgetOperatorDelete () const
 
void setOperatorDelete (FunctionDecl *D)
 
bool isArray () const
 
ExprgetArraySize ()
 
const ExprgetArraySize () const
 
unsigned getNumPlacementArgs () const
 
Expr ** getPlacementArgs ()
 
ExprgetPlacementArg (unsigned i)
 
const ExprgetPlacementArg (unsigned i) const
 
bool isParenTypeId () const
 
SourceRange getTypeIdParens () const
 
bool isGlobalNew () const
 
bool hasInitializer () const
 Whether this new-expression has any initializer at all. More...
 
InitializationStyle getInitializationStyle () const
 The kind of initializer this new-expression has. More...
 
ExprgetInitializer ()
 The initializer of this new-expression. More...
 
const ExprgetInitializer () const
 
const CXXConstructExprgetConstructExpr () const
 Returns the CXXConstructExpr from this new-expression, or null. More...
 
bool doesUsualArrayDeleteWantSize () const
 
arg_iterator placement_arg_begin ()
 
arg_iterator placement_arg_end ()
 
const_arg_iterator placement_arg_begin () const
 
const_arg_iterator placement_arg_end () const
 
raw_arg_iterator raw_arg_begin ()
 
raw_arg_iterator raw_arg_end ()
 
const_arg_iterator raw_arg_begin () const
 
const_arg_iterator raw_arg_end () const
 
SourceLocation getStartLoc () const
 
SourceLocation getEndLoc () const
 
SourceRange getDirectInitRange () const
 
SourceRange getSourceRange () const LLVM_READONLY
 
SourceLocation getLocStart () const LLVM_READONLY
 
SourceLocation getLocEnd () const LLVM_READONLY
 
child_range children ()
 
- Public Member Functions inherited from clang::Expr
QualType getType () const
 
void setType (QualType t)
 
bool isValueDependent () const
 
void setValueDependent (bool VD)
 Set whether this expression is value-dependent or not. More...
 
bool isTypeDependent () const
 
void setTypeDependent (bool TD)
 Set whether this expression is type-dependent or not. More...
 
bool isInstantiationDependent () const
 Whether this expression is instantiation-dependent, meaning that it depends in some way on a template parameter, even if neither its type nor (constant) value can change due to the template instantiation. More...
 
void setInstantiationDependent (bool ID)
 Set whether this expression is instantiation-dependent or not. More...
 
bool containsUnexpandedParameterPack () const
 Whether this expression contains an unexpanded parameter pack (for C++11 variadic templates). More...
 
void setContainsUnexpandedParameterPack (bool PP=true)
 Set the bit that describes whether this expression contains an unexpanded parameter pack. More...
 
SourceLocation getExprLoc () const LLVM_READONLY
 
bool isUnusedResultAWarning (const Expr *&WarnExpr, SourceLocation &Loc, SourceRange &R1, SourceRange &R2, ASTContext &Ctx) const
 
bool isLValue () const
 
bool isRValue () const
 
bool isXValue () const
 
bool isGLValue () const
 
LValueClassification ClassifyLValue (ASTContext &Ctx) const
 Reasons why an expression might not be an l-value. More...
 
isModifiableLvalueResult isModifiableLvalue (ASTContext &Ctx, SourceLocation *Loc=nullptr) const
 
Classification Classify (ASTContext &Ctx) const
 Classify - Classify this expression according to the C++11 expression taxonomy. More...
 
Classification ClassifyModifiable (ASTContext &Ctx, SourceLocation &Loc) const
 ClassifyModifiable - Classify this expression according to the C++11 expression taxonomy, and see if it is valid on the left side of an assignment. More...
 
ExprValueKind getValueKind () const
 getValueKind - The value kind that this expression produces. More...
 
ExprObjectKind getObjectKind () const
 
bool isOrdinaryOrBitFieldObject () const
 
void setValueKind (ExprValueKind Cat)
 setValueKind - Set the value kind produced by this expression. More...
 
void setObjectKind (ExprObjectKind Cat)
 setObjectKind - Set the object kind produced by this expression. More...
 
bool refersToBitField () const
 Returns true if this expression is a gl-value that potentially refers to a bit-field. More...
 
FieldDeclgetSourceBitField ()
 If this expression refers to a bit-field, retrieve the declaration of that bit-field. More...
 
const FieldDeclgetSourceBitField () const
 
const ObjCPropertyRefExprgetObjCProperty () const
 If this expression is an l-value for an Objective C property, find the underlying property reference expression. More...
 
bool isObjCSelfExpr () const
 Check if this expression is the ObjC 'self' implicit parameter. More...
 
bool refersToVectorElement () const
 Returns whether this expression refers to a vector element. More...
 
bool hasPlaceholderType () const
 Returns whether this expression has a placeholder type. More...
 
bool hasPlaceholderType (BuiltinType::Kind K) const
 Returns whether this expression has a specific placeholder type. More...
 
bool isKnownToHaveBooleanValue () const
 
bool isIntegerConstantExpr (llvm::APSInt &Result, const ASTContext &Ctx, SourceLocation *Loc=nullptr, bool isEvaluated=true) const
 
bool isIntegerConstantExpr (const ASTContext &Ctx, SourceLocation *Loc=nullptr) const
 
bool isCXX98IntegralConstantExpr (const ASTContext &Ctx) const
 
bool isCXX11ConstantExpr (const ASTContext &Ctx, APValue *Result=nullptr, SourceLocation *Loc=nullptr) const
 
bool isConstantInitializer (ASTContext &Ctx, bool ForRef, const Expr **Culprit=nullptr) const
 
bool EvaluateAsRValue (EvalResult &Result, const ASTContext &Ctx) const
 
bool EvaluateAsBooleanCondition (bool &Result, const ASTContext &Ctx) const
 
bool EvaluateAsInt (llvm::APSInt &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
 
bool isEvaluatable (const ASTContext &Ctx) const
 
bool HasSideEffects (const ASTContext &Ctx, bool IncludePossibleEffects=true) const
 
bool hasNonTrivialCall (const ASTContext &Ctx) const
 Determine whether this expression involves a call to any function that is not trivial. More...
 
llvm::APSInt EvaluateKnownConstInt (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const
 
void EvaluateForOverflow (const ASTContext &Ctx) const
 
bool EvaluateAsLValue (EvalResult &Result, const ASTContext &Ctx) const
 
bool EvaluateAsInitializer (APValue &Result, const ASTContext &Ctx, const VarDecl *VD, SmallVectorImpl< PartialDiagnosticAt > &Notes) const
 
bool EvaluateWithSubstitution (APValue &Value, ASTContext &Ctx, const FunctionDecl *Callee, ArrayRef< const Expr * > Args) const
 
NullPointerConstantKind isNullPointerConstant (ASTContext &Ctx, NullPointerConstantValueDependence NPC) const
 
bool isOBJCGCCandidate (ASTContext &Ctx) const
 
bool isBoundMemberFunction (ASTContext &Ctx) const
 Returns true if this expression is a bound member function. More...
 
ExprIgnoreImpCasts () LLVM_READONLY
 
ExprIgnoreImplicit () LLVM_READONLY
 
const ExprIgnoreImplicit () const LLVM_READONLY
 
ExprIgnoreParens () LLVM_READONLY
 
ExprIgnoreParenCasts () LLVM_READONLY
 
ExprIgnoreCasts () LLVM_READONLY
 Ignore casts. Strip off any CastExprs, returning their operand. More...
 
ExprIgnoreParenImpCasts () LLVM_READONLY
 
ExprIgnoreConversionOperator () LLVM_READONLY
 
const ExprIgnoreConversionOperator () const LLVM_READONLY
 
const ExprIgnoreParenImpCasts () const LLVM_READONLY
 
ExprIgnoreParenLValueCasts () LLVM_READONLY
 
const ExprIgnoreParenLValueCasts () const LLVM_READONLY
 
ExprIgnoreParenNoopCasts (ASTContext &Ctx) LLVM_READONLY
 
ExprignoreParenBaseCasts () LLVM_READONLY
 Ignore parentheses and derived-to-base casts. More...
 
const ExprignoreParenBaseCasts () const LLVM_READONLY
 
bool isDefaultArgument () const
 Determine whether this expression is a default function argument. More...
 
bool isTemporaryObject (ASTContext &Ctx, const CXXRecordDecl *TempTy) const
 Determine whether the result of this expression is a temporary object of the given class type. More...
 
bool isImplicitCXXThis () const
 Whether this expression is an implicit reference to 'this' in C++. More...
 
const ExprIgnoreImpCasts () const LLVM_READONLY
 
const ExprIgnoreParens () const LLVM_READONLY
 
const ExprIgnoreParenCasts () const LLVM_READONLY
 
const ExprIgnoreCasts () const LLVM_READONLY
 Strip off casts, but keep parentheses. More...
 
const ExprIgnoreParenNoopCasts (ASTContext &Ctx) const LLVM_READONLY
 
const CXXRecordDeclgetBestDynamicClassType () const
 For an expression of class type or pointer to class type, return the most derived class decl the expression is known to refer to. More...
 
const ExprskipRValueSubobjectAdjustments (SmallVectorImpl< const Expr * > &CommaLHS, SmallVectorImpl< SubobjectAdjustment > &Adjustments) const
 

Static Public Member Functions

static bool classof (const Stmt *T)
 
- Static Public Member Functions inherited from clang::Expr
static ExprValueKind getValueKindForType (QualType T)
 
static bool isPotentialConstantExpr (const FunctionDecl *FD, SmallVectorImpl< PartialDiagnosticAt > &Diags)
 
static bool isPotentialConstantExprUnevaluated (Expr *E, const FunctionDecl *FD, SmallVectorImpl< PartialDiagnosticAt > &Diags)
 
static QualType findBoundMemberType (const Expr *expr)
 Given an expression of bound-member type, find the type of the member. Returns null if this is an overloaded bound member expression. More...
 
static bool hasAnyTypeDependentArguments (ArrayRef< Expr * > Exprs)
 
static bool classof (const Stmt *T)
 

Friends

class ASTStmtReader
 
class ASTStmtWriter
 

Additional Inherited Members

- Protected Member Functions inherited from clang::Expr
 Expr (StmtClass SC, QualType T, ExprValueKind VK, ExprObjectKind OK, bool TD, bool VD, bool ID, bool ContainsUnexpandedParameterPack)
 
 Expr (StmtClass SC, EmptyShell)
 Construct an empty expression. More...
 

Detailed Description

Represents a new-expression for memory allocation and constructor calls, e.g: "new CXXNewExpr(foo)".

Definition at line 1623 of file ExprCXX.h.

Member Typedef Documentation

Definition at line 1770 of file ExprCXX.h.

Definition at line 1771 of file ExprCXX.h.

Definition at line 1786 of file ExprCXX.h.

Member Enumeration Documentation

Enumerator
NoInit 

New-expression has no initializer as written.

CallInit 

New-expression has a C++98 paren-delimited initializer.

ListInit 

New-expression has a C++11 list-initializer.

Definition at line 1663 of file ExprCXX.h.

Constructor & Destructor Documentation

CXXNewExpr::CXXNewExpr ( const ASTContext C,
bool  globalNew,
FunctionDecl operatorNew,
FunctionDecl operatorDelete,
bool  usualArrayDeleteWantsSize,
ArrayRef< Expr * >  placementArgs,
SourceRange  typeIdParens,
Expr arraySize,
InitializationStyle  initializationStyle,
Expr initializer,
QualType  ty,
TypeSourceInfo AllocatedTypeInfo,
SourceRange  Range,
SourceRange  directInitRange 
)
clang::CXXNewExpr::CXXNewExpr ( EmptyShell  Shell)
inlineexplicit

Definition at line 1676 of file ExprCXX.h.

Member Function Documentation

void CXXNewExpr::AllocateArgsArray ( const ASTContext C,
bool  isArray,
unsigned  numPlaceArgs,
bool  hasInitializer 
)

Definition at line 200 of file ExprCXX.cpp.

References AttributeLangSupport::C, and isArray().

Referenced by CXXNewExpr().

child_range clang::CXXNewExpr::children ( )
inline

Definition at line 1812 of file ExprCXX.h.

References raw_arg_begin(), and raw_arg_end().

static bool clang::CXXNewExpr::classof ( const Stmt T)
inlinestatic

Definition at line 1807 of file ExprCXX.h.

bool clang::CXXNewExpr::doesUsualArrayDeleteWantSize ( ) const
inline

Answers whether the usual array deallocation function for the allocated type expects the size of the allocation as a parameter.

Definition at line 1766 of file ExprCXX.h.

Referenced by clang::CodeGen::CGCXXABI::requiresArrayCookie().

QualType clang::CXXNewExpr::getAllocatedType ( ) const
inline
TypeSourceInfo* clang::CXXNewExpr::getAllocatedTypeSourceInfo ( ) const
inline

Definition at line 1687 of file ExprCXX.h.

Expr* clang::CXXNewExpr::getArraySize ( )
inline

Definition at line 1714 of file ExprCXX.h.

Referenced by EmitCXXNewAllocSize().

const Expr* clang::CXXNewExpr::getArraySize ( ) const
inline

Definition at line 1717 of file ExprCXX.h.

const CXXConstructExpr* clang::CXXNewExpr::getConstructExpr ( ) const
inline

Returns the CXXConstructExpr from this new-expression, or null.

Definition at line 1759 of file ExprCXX.h.

References getInitializer().

Referenced by treatUnusedNewEscaped().

SourceRange clang::CXXNewExpr::getDirectInitRange ( ) const
inline

Definition at line 1799 of file ExprCXX.h.

SourceLocation clang::CXXNewExpr::getEndLoc ( ) const
inline

Definition at line 1797 of file ExprCXX.h.

References clang::SourceRange::getEnd().

Referenced by getLocEnd().

InitializationStyle clang::CXXNewExpr::getInitializationStyle ( ) const
inline

The kind of initializer this new-expression has.

Definition at line 1744 of file ExprCXX.h.

References NoInit.

Referenced by CXXNewExpr().

Expr* clang::CXXNewExpr::getInitializer ( )
inline
const Expr* clang::CXXNewExpr::getInitializer ( ) const
inline

Definition at line 1754 of file ExprCXX.h.

References hasInitializer().

SourceLocation clang::CXXNewExpr::getLocEnd ( ) const
inline

Definition at line 1805 of file ExprCXX.h.

References getEndLoc().

SourceLocation clang::CXXNewExpr::getLocStart ( ) const
inline

Definition at line 1804 of file ExprCXX.h.

References getStartLoc().

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

unsigned clang::CXXNewExpr::getNumPlacementArgs ( ) const
inline

Definition at line 1721 of file ExprCXX.h.

Referenced by EnterNewDeleteCleanup(), placement_arg_end(), and raw_arg_end().

FunctionDecl* clang::CXXNewExpr::getOperatorDelete ( ) const
inline
FunctionDecl* clang::CXXNewExpr::getOperatorNew ( ) const
inline
Expr* clang::CXXNewExpr::getPlacementArg ( unsigned  i)
inline

Definition at line 1726 of file ExprCXX.h.

References getPlacementArgs().

Referenced by getPlacementArg(), and clang::ento::ExprEngine::VisitCXXNewExpr().

const Expr* clang::CXXNewExpr::getPlacementArg ( unsigned  i) const
inline

Definition at line 1730 of file ExprCXX.h.

References getPlacementArg().

Expr** clang::CXXNewExpr::getPlacementArgs ( )
inline

Definition at line 1722 of file ExprCXX.h.

References hasInitializer().

Referenced by getPlacementArg().

SourceRange clang::CXXNewExpr::getSourceRange ( ) const
inline

Definition at line 1801 of file ExprCXX.h.

Referenced by CXXNewExpr().

SourceLocation clang::CXXNewExpr::getStartLoc ( ) const
inline
SourceRange clang::CXXNewExpr::getTypeIdParens ( ) const
inline

Definition at line 1736 of file ExprCXX.h.

bool clang::CXXNewExpr::hasInitializer ( ) const
inline
bool clang::CXXNewExpr::isArray ( ) const
inline
bool clang::CXXNewExpr::isGlobalNew ( ) const
inline

Definition at line 1738 of file ExprCXX.h.

bool clang::CXXNewExpr::isParenTypeId ( ) const
inline

Definition at line 1735 of file ExprCXX.h.

References clang::SourceRange::isValid().

arg_iterator clang::CXXNewExpr::placement_arg_begin ( )
inline

Definition at line 1773 of file ExprCXX.h.

References hasInitializer().

Referenced by clang::CodeGen::CodeGenFunction::EmitCXXNewExpr().

const_arg_iterator clang::CXXNewExpr::placement_arg_begin ( ) const
inline

Definition at line 1779 of file ExprCXX.h.

References hasInitializer().

arg_iterator clang::CXXNewExpr::placement_arg_end ( )
inline

Definition at line 1776 of file ExprCXX.h.

References getNumPlacementArgs(), and hasInitializer().

Referenced by clang::CodeGen::CodeGenFunction::EmitCXXNewExpr().

const_arg_iterator clang::CXXNewExpr::placement_arg_end ( ) const
inline

Definition at line 1782 of file ExprCXX.h.

References getNumPlacementArgs(), and hasInitializer().

raw_arg_iterator clang::CXXNewExpr::raw_arg_begin ( )
inline

Definition at line 1787 of file ExprCXX.h.

Referenced by children().

const_arg_iterator clang::CXXNewExpr::raw_arg_begin ( ) const
inline

Definition at line 1791 of file ExprCXX.h.

raw_arg_iterator clang::CXXNewExpr::raw_arg_end ( )
inline

Definition at line 1788 of file ExprCXX.h.

References getNumPlacementArgs(), and hasInitializer().

Referenced by children().

const_arg_iterator clang::CXXNewExpr::raw_arg_end ( ) const
inline

Definition at line 1792 of file ExprCXX.h.

References getNumPlacementArgs(), and hasInitializer().

void clang::CXXNewExpr::setOperatorDelete ( FunctionDecl D)
inline

Definition at line 1711 of file ExprCXX.h.

void clang::CXXNewExpr::setOperatorNew ( FunctionDecl D)
inline

Definition at line 1709 of file ExprCXX.h.

bool CXXNewExpr::shouldNullCheckAllocation ( const ASTContext Ctx) const

True if the allocation result needs to be null-checked.

C++11 [expr.new]p13: If the allocation function returns null, initialization shall not be done, the deallocation function shall not be called, and the value of the new-expression shall be null.

C++ DR1748: If the allocation function is a reserved placement allocation function that returns null, the behavior is undefined.

An allocation function is not allowed to return null unless it has a non-throwing exception-specification. The '03 rule is identical except that the definition of a non-throwing exception specification is just "is it throw()?".

Definition at line 210 of file ExprCXX.cpp.

References clang::Type::castAs(), getOperatorNew(), clang::ValueDecl::getType(), and clang::FunctionDecl::isReservedGlobalPlacementOperator().

Referenced by clang::CodeGen::CodeGenFunction::EmitCXXNewExpr().

Friends And Related Function Documentation

friend class ASTStmtReader
friend

Definition at line 1660 of file ExprCXX.h.

friend class ASTStmtWriter
friend

Definition at line 1661 of file ExprCXX.h.


The documentation for this class was generated from the following files: