This represents one expression. More...

#include "clang/AST/Expr.h"

Inherited by clang::AbstractConditionalOperator, clang::AddrLabelExpr, clang::ArrayInitIndexExpr, clang::ArrayInitLoopExpr, clang::ArraySubscriptExpr, clang::ArrayTypeTraitExpr, clang::AsTypeExpr, clang::AtomicExpr, clang::BinaryOperator, clang::BlockExpr, clang::CallExpr, clang::CastExpr, clang::CharacterLiteral, clang::ChooseExpr, clang::CompoundLiteralExpr, clang::ConvertVectorExpr, clang::CoroutineSuspendExpr, clang::CXXBindTemporaryExpr, clang::CXXBoolLiteralExpr, clang::CXXConstructExpr, clang::CXXDefaultArgExpr, clang::CXXDefaultInitExpr, clang::CXXDeleteExpr, clang::CXXDependentScopeMemberExpr, clang::CXXFoldExpr, clang::CXXInheritedCtorInitExpr, clang::CXXNewExpr, clang::CXXNoexceptExpr, clang::CXXNullPtrLiteralExpr, clang::CXXPseudoDestructorExpr, clang::CXXScalarValueInitExpr, clang::CXXStdInitializerListExpr, clang::CXXThisExpr, clang::CXXThrowExpr, clang::CXXTypeidExpr, clang::CXXUnresolvedConstructExpr, clang::CXXUuidofExpr, clang::DeclRefExpr, clang::DependentCoawaitExpr, clang::DependentScopeDeclRefExpr, clang::DesignatedInitExpr, clang::DesignatedInitUpdateExpr, clang::ExpressionTraitExpr, clang::ExtVectorElementExpr, clang::FixedPointLiteral, clang::FloatingLiteral, clang::FullExpr, clang::FunctionParmPackExpr, clang::GenericSelectionExpr, clang::GNUNullExpr, clang::ImaginaryLiteral, clang::ImplicitValueInitExpr, clang::InitListExpr, clang::IntegerLiteral, clang::LambdaExpr, clang::MaterializeTemporaryExpr, clang::MemberExpr, clang::MSPropertyRefExpr, clang::MSPropertySubscriptExpr, clang::NoInitExpr, clang::ObjCArrayLiteral, clang::ObjCAvailabilityCheckExpr, clang::ObjCBoolLiteralExpr, clang::ObjCBoxedExpr, clang::ObjCDictionaryLiteral, clang::ObjCEncodeExpr, clang::ObjCIndirectCopyRestoreExpr, clang::ObjCIsaExpr, clang::ObjCIvarRefExpr, clang::ObjCMessageExpr, clang::ObjCPropertyRefExpr, clang::ObjCProtocolExpr, clang::ObjCSelectorExpr, clang::ObjCStringLiteral, clang::ObjCSubscriptRefExpr, clang::OffsetOfExpr, clang::OMPArraySectionExpr, clang::OpaqueValueExpr, clang::OverloadExpr, clang::PackExpansionExpr, clang::ParenExpr, clang::ParenListExpr, clang::PredefinedExpr, clang::PseudoObjectExpr, clang::ShuffleVectorExpr, clang::SizeOfPackExpr, clang::StmtExpr, clang::StringLiteral, clang::SubstNonTypeTemplateParmExpr, clang::SubstNonTypeTemplateParmPackExpr, clang::TypeTraitExpr, clang::TypoExpr, clang::UnaryExprOrTypeTraitExpr, clang::UnaryOperator, and clang::VAArgExpr.

Collaboration diagram for clang::Expr:

[legend]

Classes
class	Classification
	The return type of classify(). More...

struct	EvalResult
	EvalResult is a struct with detailed info about an evaluated expression. More...

struct	EvalStatus
	EvalStatus is a struct with detailed info about an evaluation in progress. More...

Public Types
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_ConstQualifiedField, MLV_ConstAddrSpace, MLV_ArrayType, MLV_NoSetterProperty, MLV_MemberFunction, MLV_SubObjCPropertySetting, MLV_InvalidMessageExpression, MLV_ClassTemporary, MLV_ArrayTemporary }

enum	SideEffectsKind { SE_NoSideEffects, SE_AllowUndefinedBehavior, SE_AllowSideEffects }

enum	ConstExprUsage { EvaluateForCodeGen, EvaluateForMangling }
	Indicates how the constant expression will be used. More...

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 Types inherited from clang::Stmt
enum	StmtClass { NoStmtClass = 0 }

using	child_iterator = StmtIterator
	Child Iterators: All subclasses must implement 'children' to permit easy iteration over the substatements/subexpessions of an AST node. More...

using	const_child_iterator = ConstStmtIterator

using	child_range = llvm::iterator_range< child_iterator >

using	const_child_range = llvm::iterator_range< const_child_iterator >

Public Member Functions
QualType	getType () const

void	setType (QualType t)

bool	isValueDependent () const
	isValueDependent - Determines whether this expression is value-dependent (C++ [temp.dep.constexpr]). More...

void	setValueDependent (bool VD)
	Set whether this expression is value-dependent or not. More...

bool	isTypeDependent () const
	isTypeDependent - Determines whether this expression is type-dependent (C++ [temp.dep.expr]), which means that its type could change from one template instantiation to the next. More...

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
	getExprLoc - Return the preferred location for the arrow when diagnosing a problem with a generic expression. More...

bool	isUnusedResultAWarning (const Expr *&WarnExpr, SourceLocation &Loc, SourceRange &R1, SourceRange &R2, ASTContext &Ctx) const
	isUnusedResultAWarning - Return true if this immediate expression should be warned about if the result is unused. More...

bool	isLValue () const
	isLValue - True if this expression is an "l-value" according to the rules of the current language. More...

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
	isModifiableLvalue - C99 6.3.2.1: an lvalue that does not have array type, does not have an incomplete type, does not have a const-qualified type, and if it is a structure or union, does not have any member (including, recursively, any member or element of all contained aggregates or unions) with a const-qualified type. More...

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
	getObjectKind - The object kind that this expression produces. More...

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...

FieldDecl *	getSourceBitField ()
	If this expression refers to a bit-field, retrieve the declaration of that bit-field. More...

const FieldDecl *	getSourceBitField () const

Decl *	getReferencedDeclOfCallee ()

const Decl *	getReferencedDeclOfCallee () const

const ObjCPropertyRefExpr *	getObjCProperty () 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	refersToGlobalRegisterVar () const
	Returns whether this expression refers to a global register variable. 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
	isKnownToHaveBooleanValue - Return true if this is an integer expression that is known to return 0 or 1. More...

bool	isIntegerConstantExpr (llvm::APSInt &Result, const ASTContext &Ctx, SourceLocation *Loc=nullptr, bool isEvaluated=true) const
	isIntegerConstantExpr - Return true if this expression is a valid integer constant expression, and, if so, return its value in Result. More...

bool	isIntegerConstantExpr (const ASTContext &Ctx, SourceLocation *Loc=nullptr) const

bool	isCXX98IntegralConstantExpr (const ASTContext &Ctx) const
	isCXX98IntegralConstantExpr - Return true if this expression is an integral constant expression in C++98. More...

bool	isCXX11ConstantExpr (const ASTContext &Ctx, APValue Result=nullptr, SourceLocation Loc=nullptr) const
	isCXX11ConstantExpr - Return true if this expression is a constant expression in C++11. More...

bool	isConstantInitializer (ASTContext &Ctx, bool ForRef, const Expr **Culprit=nullptr) const
	isConstantInitializer - Returns true if this expression can be emitted to IR as a constant, and thus can be used as a constant initializer in C. More...

bool	EvaluateAsRValue (EvalResult &Result, const ASTContext &Ctx, bool InConstantContext=false) const
	EvaluateAsRValue - Return true if this is a constant which we can fold to an rvalue using any crazy technique (that has nothing to do with language standards) that we want to, even if the expression has side-effects. More...

bool	EvaluateAsBooleanCondition (bool &Result, const ASTContext &Ctx) const
	EvaluateAsBooleanCondition - Return true if this is a constant which we can fold and convert to a boolean condition using any crazy technique that we want to, even if the expression has side-effects. More...

bool	EvaluateAsInt (EvalResult &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
	EvaluateAsInt - Return true if this is a constant which we can fold and convert to an integer, using any crazy technique that we want to. More...

bool	EvaluateAsFloat (llvm::APFloat &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
	EvaluateAsFloat - Return true if this is a constant which we can fold and convert to a floating point value, using any crazy technique that we want to. More...

bool	isEvaluatable (const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
	isEvaluatable - Call EvaluateAsRValue to see if this expression can be constant folded without side-effects, but discard the result. More...

bool	HasSideEffects (const ASTContext &Ctx, bool IncludePossibleEffects=true) const
	HasSideEffects - This routine returns true for all those expressions which have any effect other than producing a value. More...

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
	EvaluateKnownConstInt - Call EvaluateAsRValue and return the folded integer. More...

llvm::APSInt	EvaluateKnownConstIntCheckOverflow (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const

void	EvaluateForOverflow (const ASTContext &Ctx) const

bool	EvaluateAsLValue (EvalResult &Result, const ASTContext &Ctx) const
	EvaluateAsLValue - Evaluate an expression to see if we can fold it to an lvalue with link time known address, with no side-effects. More...

bool	EvaluateAsInitializer (APValue &Result, const ASTContext &Ctx, const VarDecl *VD, SmallVectorImpl< PartialDiagnosticAt > &Notes) const
	EvaluateAsInitializer - Evaluate an expression as if it were the initializer of the given declaration. More...

bool	EvaluateWithSubstitution (APValue &Value, ASTContext &Ctx, const FunctionDecl Callee, ArrayRef< const Expr > Args, const Expr *This=nullptr) const
	EvaluateWithSubstitution - Evaluate an expression as if from the context of a call to the given function with the given arguments, inside an unevaluated context. More...

bool	EvaluateAsConstantExpr (EvalResult &Result, ConstExprUsage Usage, const ASTContext &Ctx) const
	Evaluate an expression that is required to be a constant expression. More...

bool	tryEvaluateObjectSize (uint64_t &Result, ASTContext &Ctx, unsigned Type) const
	If the current Expr is a pointer, this will try to statically determine the number of bytes available where the pointer is pointing. More...

NullPointerConstantKind	isNullPointerConstant (ASTContext &Ctx, NullPointerConstantValueDependence NPC) const
	isNullPointerConstant - C99 6.3.2.3p3 - Test if this reduces down to a Null pointer constant. More...

bool	isOBJCGCCandidate (ASTContext &Ctx) const
	isOBJCGCCandidate - Return true if this expression may be used in a read/ write barrier. More...

bool	isBoundMemberFunction (ASTContext &Ctx) const
	Returns true if this expression is a bound member function. More...

Expr *	IgnoreImpCasts () LLVM_READONLY
	IgnoreImpCasts - Skip past any implicit casts which might surround this expression. More...

Expr *	IgnoreImplicit () LLVM_READONLY
	IgnoreImplicit - Skip past any implicit AST nodes which might surround this expression. More...

const Expr *	IgnoreImplicit () const LLVM_READONLY

Expr *	IgnoreParens () LLVM_READONLY
	IgnoreParens - Ignore parentheses. More...

Expr *	IgnoreParenCasts () LLVM_READONLY
	IgnoreParenCasts - Ignore parentheses and casts. More...

Expr *	IgnoreCasts () LLVM_READONLY
	Ignore casts. Strip off any CastExprs, returning their operand. More...

Expr *	IgnoreParenImpCasts () LLVM_READONLY
	IgnoreParenImpCasts - Ignore parentheses and implicit casts. More...

Expr *	IgnoreConversionOperator () LLVM_READONLY
	IgnoreConversionOperator - Ignore conversion operator. More...

const Expr *	IgnoreConversionOperator () const LLVM_READONLY

const Expr *	IgnoreParenImpCasts () const LLVM_READONLY

Expr *	IgnoreParenLValueCasts () LLVM_READONLY
	Ignore parentheses and lvalue casts. More...

const Expr *	IgnoreParenLValueCasts () const LLVM_READONLY

Expr *	IgnoreParenNoopCasts (ASTContext &Ctx) LLVM_READONLY
	IgnoreParenNoopCasts - Ignore parentheses and casts that do not change the value (including ptr->int casts of the same size). More...

Expr *	ignoreParenBaseCasts () LLVM_READONLY
	Ignore parentheses and derived-to-base casts. More...

const Expr *	ignoreParenBaseCasts () 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 Expr *	IgnoreImpCasts () const LLVM_READONLY

const Expr *	IgnoreParens () const LLVM_READONLY

const Expr *	IgnoreParenCasts () const LLVM_READONLY

const Expr *	IgnoreCasts () const LLVM_READONLY
	Strip off casts, but keep parentheses. More...

const Expr *	IgnoreParenNoopCasts (ASTContext &Ctx) const LLVM_READONLY

const CXXRecordDecl *	getBestDynamicClassType () 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 Expr *	getBestDynamicClassTypeExpr () const
	Get the inner expression that determines the best dynamic class. More...

const Expr *	skipRValueSubobjectAdjustments (SmallVectorImpl< const Expr *> &CommaLHS, SmallVectorImpl< SubobjectAdjustment > &Adjustments) const
	Walk outwards from an expression we want to bind a reference to and find the expression whose lifetime needs to be extended. More...

const Expr *	skipRValueSubobjectAdjustments () const

Public Member Functions inherited from clang::Stmt
void *	operator new (size_t bytes, const ASTContext &C, unsigned alignment=8)

void *	operator new (size_t bytes, const ASTContext *C, unsigned alignment=8)

void *	operator new (size_t bytes, void *mem) noexcept

void	operator delete (void *, const ASTContext &, unsigned) noexcept

void	operator delete (void , const ASTContext , unsigned) noexcept

void	operator delete (void *, size_t) noexcept

void	operator delete (void , void ) noexcept

	Stmt (StmtClass SC)

StmtClass	getStmtClass () const

const char *	getStmtClassName () const

SourceRange	getSourceRange () const LLVM_READONLY
	SourceLocation tokens are not useful in isolation - they are low level value objects created/interpreted by SourceManager. More...

SourceLocation	getBeginLoc () const LLVM_READONLY

SourceLocation	getEndLoc () const LLVM_READONLY

void	dump () const
	Dumps the specified AST fragment and all subtrees to `llvm::errs()`. More...

void	dump (SourceManager &SM) const

void	dump (raw_ostream &OS, SourceManager &SM) const

void	dump (raw_ostream &OS) const

int64_t	getID (const ASTContext &Context) const

void	dumpColor () const
	dumpColor - same as dump(), but forces color highlighting. More...

void	dumpPretty (const ASTContext &Context) const
	dumpPretty/printPretty - These two methods do a "pretty print" of the AST back to its original source language syntax. More...

void	printPretty (raw_ostream &OS, PrinterHelper Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\, const ASTContext Context=nullptr) const

void	viewAST () const
	viewAST - Visualize an AST rooted at this Stmt* using GraphViz. More...

Stmt *	IgnoreImplicit ()
	Skip past any implicit AST nodes which might surround this statement, such as ExprWithCleanups or ImplicitCastExpr nodes. More...

const Stmt *	IgnoreImplicit () const

Stmt *	IgnoreContainers (bool IgnoreCaptured=false)
	Skip no-op (attributed, compound) container stmts and skip captured stmt at the top, if IgnoreCaptured is true. More...

const Stmt *	IgnoreContainers (bool IgnoreCaptured=false) const

const Stmt *	stripLabelLikeStatements () const
	Strip off all label-like statements. More...

Stmt *	stripLabelLikeStatements ()

child_range	children ()

const_child_range	children () const

child_iterator	child_begin ()

child_iterator	child_end ()

const_child_iterator	child_begin () const

const_child_iterator	child_end () const

void	Profile (llvm::FoldingSetNodeID &ID, const ASTContext &Context, bool Canonical) const
	Produce a unique representation of the given statement. More...

void	ProcessODRHash (llvm::FoldingSetNodeID &ID, ODRHash &Hash) const
	Calculate a unique representation for a statement that is stable across compiler invocations. More...

Static Public Member Functions
static ExprValueKind	getValueKindForType (QualType T)
	getValueKindForType - Given a formal return or parameter type, give its value kind. More...

static bool	isPotentialConstantExpr (const FunctionDecl *FD, SmallVectorImpl< PartialDiagnosticAt > &Diags)
	isPotentialConstantExpr - Return true if this function's definition might be usable in a constant expression in C++11, if it were marked constexpr. More...

static bool	isPotentialConstantExprUnevaluated (Expr E, const FunctionDecl FD, SmallVectorImpl< PartialDiagnosticAt > &Diags)
	isPotentialConstantExprUnevaluted - Return true if this expression might be usable in a constant expression in C++11 in an unevaluated context, if it were in function FD marked constexpr. More...

static QualType	findBoundMemberType (const Expr *expr)
	Given an expression of bound-member type, find the type of the member. More...

static bool	hasAnyTypeDependentArguments (ArrayRef< Expr *> Exprs)
	hasAnyTypeDependentArguments - Determines if any of the expressions in Exprs is type-dependent. More...

static bool	classof (const Stmt *T)

Static Public Member Functions inherited from clang::Stmt
static void	addStmtClass (const StmtClass s)

static void	EnableStatistics ()

static void	PrintStats ()

Protected Member Functions
	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...

Protected Member Functions inherited from clang::Stmt
void *	operator new (size_t bytes) noexcept

void	operator delete (void *data) noexcept

	Stmt (StmtClass SC, EmptyShell)
	Construct an empty statement. More...

Additional Inherited Members
Protected Types inherited from clang::Stmt
enum	{ NumStmtBits = 8 }

enum	{ NumExprBits = NumStmtBits + 9 }

enum	APFloatSemantics { IEEEhalf, IEEEsingle, IEEEdouble, x87DoubleExtended, IEEEquad, PPCDoubleDouble }

Protected Attributes inherited from clang::Stmt
union {
StmtBitfields StmtBits

NullStmtBitfields NullStmtBits

CompoundStmtBitfields CompoundStmtBits

LabelStmtBitfields LabelStmtBits

AttributedStmtBitfields AttributedStmtBits

IfStmtBitfields IfStmtBits

SwitchStmtBitfields SwitchStmtBits

WhileStmtBitfields WhileStmtBits

DoStmtBitfields DoStmtBits

ForStmtBitfields ForStmtBits

GotoStmtBitfields GotoStmtBits

ContinueStmtBitfields ContinueStmtBits

BreakStmtBitfields BreakStmtBits

ReturnStmtBitfields ReturnStmtBits

SwitchCaseBitfields SwitchCaseBits

ExprBitfields ExprBits

PredefinedExprBitfields PredefinedExprBits

DeclRefExprBitfields DeclRefExprBits

FloatingLiteralBitfields FloatingLiteralBits

StringLiteralBitfields StringLiteralBits

CharacterLiteralBitfields CharacterLiteralBits

UnaryOperatorBitfields UnaryOperatorBits

UnaryExprOrTypeTraitExprBitfields UnaryExprOrTypeTraitExprBits

ArraySubscriptExprBitfields ArraySubscriptExprBits

CallExprBitfields CallExprBits

MemberExprBitfields MemberExprBits

CastExprBitfields CastExprBits

BinaryOperatorBitfields BinaryOperatorBits

InitListExprBitfields InitListExprBits

ParenListExprBitfields ParenListExprBits

PseudoObjectExprBitfields PseudoObjectExprBits

CXXBoolLiteralExprBitfields CXXBoolLiteralExprBits

CXXNullPtrLiteralExprBitfields CXXNullPtrLiteralExprBits

CXXThisExprBitfields CXXThisExprBits

CXXThrowExprBitfields CXXThrowExprBits

CXXDefaultArgExprBitfields CXXDefaultArgExprBits

CXXDefaultInitExprBitfields CXXDefaultInitExprBits

CXXDeleteExprBitfields CXXDeleteExprBits

TypeTraitExprBitfields TypeTraitExprBits

ExprWithCleanupsBitfields ExprWithCleanupsBits

CoawaitExprBitfields CoawaitBits

ObjCIndirectCopyRestoreExprBitfields ObjCIndirectCopyRestoreExprBits

OpaqueValueExprBitfields OpaqueValueExprBits

};

Detailed Description

This represents one expression.

Note that Expr's are subclasses of Stmt. This allows an expression to be transparently used any place a Stmt is required.

Definition at line 106 of file Expr.h.

Member Enumeration Documentation

◆ ConstExprUsage

enum clang::Expr::ConstExprUsage

Indicates how the constant expression will be used.

Enumerator
EvaluateForCodeGen
EvaluateForMangling

Definition at line 668 of file Expr.h.

◆ isModifiableLvalueResult

enum clang::Expr::isModifiableLvalueResult

Enumerator
MLV_Valid
MLV_NotObjectType
MLV_IncompleteVoidType
MLV_DuplicateVectorComponents
MLV_InvalidExpression
MLV_LValueCast
MLV_IncompleteType
MLV_ConstQualified
MLV_ConstQualifiedField
MLV_ConstAddrSpace
MLV_ArrayType
MLV_NoSetterProperty
MLV_MemberFunction
MLV_SubObjCPropertySetting
MLV_InvalidMessageExpression
MLV_ClassTemporary
MLV_ArrayTemporary

Definition at line 269 of file Expr.h.

◆ LValueClassification

enum clang::Expr::LValueClassification

Enumerator
LV_Valid
LV_NotObjectType
LV_IncompleteVoidType
LV_DuplicateVectorComponents
LV_InvalidExpression
LV_InvalidMessageExpression
LV_MemberFunction
LV_SubObjCPropertySetting
LV_ClassTemporary
LV_ArrayTemporary

Definition at line 254 of file Expr.h.

◆ NullPointerConstantKind

enum clang::Expr::NullPointerConstantKind

Enumeration used to describe the kind of Null pointer constant returned from isNullPointerConstant().

Enumerator
NPCK_NotNull	Expression is not a Null pointer constant.
NPCK_ZeroExpression	Expression is a Null pointer constant built from a zero integer expression that is not a simple, possibly parenthesized, zero literal. C++ Core Issue 903 will classify these expressions as "not pointers" once it is adopted. http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_active.html#903
NPCK_ZeroLiteral	Expression is a Null pointer constant built from a literal zero.
NPCK_CXX11_nullptr	Expression is a C++11 nullptr.
NPCK_GNUNull	Expression is a GNU-style __null constant.

Definition at line 686 of file Expr.h.

◆ NullPointerConstantValueDependence

enum clang::Expr::NullPointerConstantValueDependence

Enumeration used to describe how isNullPointerConstant() should cope with value-dependent expressions.

Enumerator
NPC_NeverValueDependent	Specifies that the expression should never be value-dependent.
NPC_ValueDependentIsNull	Specifies that a value-dependent expression of integral or dependent type should be considered a null pointer constant.
NPC_ValueDependentIsNotNull	Specifies that a value-dependent expression should be considered to never be a null pointer constant.

Definition at line 709 of file Expr.h.

◆ SideEffectsKind

enum clang::Expr::SideEffectsKind

Enumerator
SE_NoSideEffects	Strictly evaluate the expression.
SE_AllowUndefinedBehavior	Allow UB that we can give a value, but not arbitrary unmodeled side effects.
SE_AllowSideEffects	Allow any unmodeled side effect.

Definition at line 595 of file Expr.h.

Constructor & Destructor Documentation

◆ Expr() [1/2]

clang::Expr::Expr	(	StmtClass	SC,
		QualType	T,
		ExprValueKind	VK,
		ExprObjectKind	OK,
		bool	TD,
		bool	VD,
		bool	ID,
		bool	ContainsUnexpandedParameterPack
	)

inlineprotected

Definition at line 110 of file Expr.h.

Referenced by computeDeclRefDependence(), clang::PseudoObjectExpr::Create(), clang::ObjCArrayLiteral::CreateEmpty(), clang::OffsetOfExpr::CreateEmpty(), clang::SubstNonTypeTemplateParmPackExpr::getArgumentPack(), clang::DeclRefExpr::getEndLoc(), clang::DesignatedInitUpdateExpr::getEndLoc(), clang::DesignatedInitExpr::Designator::getFieldName(), clang::OverloadExpr::getNamingClass(), clang::ObjCPropertyRefExpr::getReceiverType(), clang::UserDefinedLiteral::getUDSuffix(), clang::FloatingLiteral::getValueAsApproximateDouble(), and clang::MaterializeTemporaryExpr::setExtendingDecl().

◆ Expr() [2/2]

clang::Expr::Expr	(	StmtClass	SC,
		EmptyShell
	)

inlineexplicitprotected

Construct an empty expression.

Definition at line 125 of file Expr.h.

Member Function Documentation

◆ Classify()

Classification clang::Expr::Classify ( ASTContext & Ctx ) const

inline

Classify - Classify this expression according to the C++11 expression taxonomy.

C++11 defines ([basic.lval]) a new taxonomy of expressions to replace the old lvalue vs rvalue. This function determines the type of expression this is. There are three expression types:

lvalues are classical lvalues as in C++03.
prvalues are equivalent to rvalues in C++03.
xvalues are expressions yielding unnamed rvalue references, e.g. a function returning an rvalue reference. lvalues and xvalues are collectively referred to as glvalues, while prvalues and xvalues together form rvalues.

Definition at line 377 of file Expr.h.

Referenced by clang::canTypeidThrow(), ClassifyLValue(), isTemporaryObject(), TryReferenceInit(), and TryReferenceInitializationCore().

◆ ClassifyLValue()

Expr::LValueClassification Expr::ClassifyLValue ( ASTContext & Ctx ) const

Reasons why an expression might not be an l-value.

Definition at line 652 of file ExprClassification.cpp.

Referenced by isBoundMemberFunction().

◆ ClassifyModifiable()

Classification clang::Expr::ClassifyModifiable	(	ASTContext &	Ctx,
		SourceLocation &	Loc
	)		const

inline

ClassifyModifiable - Classify this expression according to the C++11 expression taxonomy, and see if it is valid on the left side of an assignment.

This function extends classify in that it also tests whether the expression is modifiable (C99 6.3.2.1p1).

Parameters

Loc	A source location that might be filled with a relevant location if the expression is not modifiable.

Definition at line 389 of file Expr.h.

Referenced by isModifiableLvalue().

◆ classof()

static bool clang::Expr::classof ( const Stmt * T )

inlinestatic

Definition at line 866 of file Expr.h.

References clang::Stmt::getStmtClass().

◆ containsUnexpandedParameterPack()

bool clang::Expr::containsUnexpandedParameterPack ( ) const

inline

Whether this expression contains an unexpanded parameter pack (for C++11 variadic templates).

Given the following function template:

template<typename F, typename ...Types>
void forward(const F &f, Types &&...args) {
  f(static_cast<Types&&>(args)...);
}

The expressions args and static_cast<Types&&>(args) both contain parameter packs.

Definition at line 214 of file Expr.h.

Referenced by clang::Sema::ActOnCXXFoldExpr(), clang::Sema::ActOnOpenMPDeclareSimdDirective(), clang::Sema::ActOnOpenMPDistScheduleClause(), clang::Sema::ActOnOpenMPFinalClause(), clang::Sema::ActOnOpenMPIfClause(), clang::Sema::ActOnOpenMPLinearClause(), clang::Sema::ActOnOpenMPScheduleClause(), clang::AtomicExpr::AtomicExpr(), clang::CallExpr::CallExpr(), checkMappableExpressionList(), clang::Sema::CheckPackExpansion(), checkSimdlenSafelenSpecified(), clang::Sema::containsUnexpandedParameterPacks(), clang::PseudoObjectExpr::Create(), clang::OffsetOfExpr::CreateEmpty(), clang::CXXConstructExpr::CXXConstructExpr(), clang::CXXNewExpr::CXXNewExpr(), clang::Sema::DiagnoseUnexpandedParameterPack(), clang::CXXUnresolvedConstructExpr::getBeginLoc(), clang::DesignatedInitUpdateExpr::getEndLoc(), clang::DesignatedInitExpr::Designator::getFieldName(), getPrivateItem(), clang::ObjCPropertyRefExpr::getReceiverType(), hasOnlyNonStaticMemberFunctions(), clang::InitListExpr::InitListExpr(), clang::DependentSizedArrayType::Profile(), clang::DependentSizedExtVectorType::Profile(), clang::DependentVectorType::Profile(), clang::CUDAKernelCallExpr::setConfig(), clang::InitListExpr::setInit(), clang::ShuffleVectorExpr::ShuffleVectorExpr(), and clang::ASTNodeImporter::VisitLambdaExpr().

◆ EvaluateAsBooleanCondition()

bool Expr::EvaluateAsBooleanCondition	(	bool &	Result,
		const ASTContext &	Ctx
	)		const

EvaluateAsBooleanCondition - Return true if this is a constant which we can fold and convert to a boolean condition using any crazy technique that we want to, even if the expression has side-effects.

Definition at line 10817 of file ExprConstant.cpp.

References EvaluateAsRValue(), and HandleConversionToBool().

Referenced by checkFormatStringExpr(), CheckNonNullExpr(), EvaluatesAsFalse(), EvaluatesAsTrue(), FindTypeTagExpr(), hasParallelIfNumThreadsClause(), and clang::CallExpr::isBuiltinAssumeFalse().

◆ EvaluateAsConstantExpr()

bool Expr::EvaluateAsConstantExpr	(	EvalResult &	Result,
		ConstExprUsage	Usage,
		const ASTContext &	Ctx
	)		const

Evaluate an expression that is required to be a constant expression.

Definition at line 10858 of file ExprConstant.cpp.

References CheckConstantExpression(), and Evaluate().

◆ EvaluateAsFloat()

bool Expr::EvaluateAsFloat	(	llvm::APFloat &	Result,
		const ASTContext &	Ctx,
		SideEffectsKind	AllowSideEffects = `SE_NoSideEffects`
	)		const

EvaluateAsFloat - Return true if this is a constant which we can fold and convert to a floating point value, using any crazy technique that we want to.

Definition at line 10830 of file ExprConstant.cpp.

References EvaluateAsRValue(), and hasUnacceptableSideEffect().

Referenced by DiagnoseFloatingImpCast().

◆ EvaluateAsInitializer()

bool Expr::EvaluateAsInitializer	(	APValue &	Result,
		const ASTContext &	Ctx,
		const VarDecl *	VD,
		SmallVectorImpl< PartialDiagnosticAt > &	Notes
	)		const

EvaluateAsInitializer - Evaluate an expression as if it were the initializer of the given declaration.

Returns true if the initializer can be folded to a constant, and produces any relevant notes. In C++11, notes will be produced if the expression is not a constant expression.

Definition at line 10869 of file ExprConstant.cpp.

References CheckConstantExpression(), clang::Expr::EvalStatus::Diag, EvaluateInPlace(), clang::ASTContext::getLangOpts(), clang::Decl::getLocation(), clang::ValueDecl::getType(), clang::VarDecl::hasLocalStorage(), clang::Expr::EvalStatus::HasSideEffects, clang::VarDecl::isConstexpr(), isRecordType(), and clang::Type::isReferenceType().

◆ EvaluateAsInt()

bool Expr::EvaluateAsInt	(	EvalResult &	Result,
		const ASTContext &	Ctx,
		SideEffectsKind	AllowSideEffects = `SE_NoSideEffects`
	)		const

EvaluateAsInt - Return true if this is a constant which we can fold and convert to an integer, using any crazy technique that we want to.

Definition at line 10824 of file ExprConstant.cpp.

References EvaluateAsInt().

Referenced by AddVariableConstraints(), AnalyzeBitFieldAssignment(), checkArrayExpressionDoesNotReferToUnitySize(), checkArrayExpressionDoesNotReferToWholeSize(), checkFormatStringExpr(), CheckImplicitConversion(), checkOpenMPLoop(), checkSimdlenSafelenSpecified(), clang::CodeGen::CodeGenFunction::ConstantFoldsToSimpleInteger(), clang::CodeGen::CodeGenFunction::EmitARMBuiltinExpr(), clang::CodeGen::CodeGenFunction::EmitOMPWorksharingLoop(), getBytesReturnedByAllocSizeCall(), clang::ento::SValBuilder::getConstantVal(), and isConstantInitializer().

◆ EvaluateAsLValue()

bool Expr::EvaluateAsLValue	(	EvalResult &	Result,
		const ASTContext &	Ctx
	)		const

EvaluateAsLValue - Evaluate an expression to see if we can fold it to an lvalue with link time known address, with no side-effects.

Definition at line 10844 of file ExprConstant.cpp.

References CheckLValueConstantExpression(), EvaluateForCodeGen, EvaluateLValue(), and clang::ASTContext::getLValueReferenceType().

Referenced by isConstantInitializer(), clang::CodeGen::CodeGenFunction::tryEmitAsConstant(), and clang::CodeGen::ConstantEmitter::tryEmitPrivate().

◆ EvaluateAsRValue()

bool Expr::EvaluateAsRValue	(	EvalResult &	Result,
		const ASTContext &	Ctx,
		bool	InConstantContext = `false`
	)		const

EvaluateAsRValue - Return true if this is a constant which we can fold to an rvalue using any crazy technique (that has nothing to do with language standards) that we want to, even if the expression has side-effects.

EvaluateAsRValue - Return true if this is a constant which we can fold using any crazy technique (that has nothing to do with language standards) that we want to.

If this function returns true, it returns the folded constant in Result. If the expression is a glvalue, an lvalue-to-rvalue conversion will be applied.

If this function returns true, it returns the folded constant in Result. If this expression is a glvalue, an lvalue-to-rvalue conversion will be applied to the result.

Definition at line 10810 of file ExprConstant.cpp.

References EvaluateAsRValue().

Referenced by CheckImplicitConversion(), clang::CodeGen::CodeGenFunction::EmitBuiltinExpr(), EvaluateBuiltinConstantP(), clang::Sema::FillInlineAsmIdentifierInfo(), GetExprRange(), isNullPointerValueTemplateArgument(), clang::CodeGen::CodeGenFunction::ShouldNullCheckClassCastValue(), clang::CodeGen::CodeGenFunction::tryEmitAsConstant(), and clang::CodeGen::ConstantEmitter::tryEmitPrivate().

◆ EvaluateForOverflow()

void Expr::EvaluateForOverflow ( const ASTContext & Ctx ) const

Definition at line 10949 of file ExprConstant.cpp.

References EvaluateAsRValue(), and FastEvaluateAsRValue().

◆ EvaluateKnownConstInt()

APSInt Expr::EvaluateKnownConstInt	(	const ASTContext &	Ctx,
		SmallVectorImpl< PartialDiagnosticAt > *	Diag = `nullptr`
	)		const

EvaluateKnownConstInt - Call EvaluateAsRValue and return the folded integer.

This must be called on an expression that constant folds to an integer.

Definition at line 10919 of file ExprConstant.cpp.

References Diag(), and EvaluateAsRValue().

Referenced by clang::Sema::ActOnOpenMPCriticalDirective(), CheckICE(), EvaluateSwitch(), isNullPointerConstant(), IsStandardConversion(), IsZeroInitializer(), clang::ento::ExprEngine::processSwitch(), shouldAddCase(), tryEvaluateBuiltinObjectSize(), and clang::ento::ExprEngine::VisitUnaryExprOrTypeTraitExpr().

◆ EvaluateKnownConstIntCheckOverflow()

APSInt Expr::EvaluateKnownConstIntCheckOverflow	(	const ASTContext &	Ctx,
		SmallVectorImpl< PartialDiagnosticAt > *	Diag = `nullptr`
	)		const

Definition at line 10934 of file ExprConstant.cpp.

References Diag(), and EvaluateAsRValue().

◆ EvaluateWithSubstitution()

bool Expr::EvaluateWithSubstitution	(	APValue &	Value,
		ASTContext &	Ctx,
		const FunctionDecl *	Callee,
		ArrayRef< const Expr *>	Args,
		const Expr *	This = `nullptr`
	)		const

EvaluateWithSubstitution - Evaluate an expression as if from the context of a call to the given function with the given arguments, inside an unevaluated context.

Returns true if the expression could be folded to a constant.

Definition at line 11496 of file ExprConstant.cpp.

◆ findBoundMemberType()

QualType Expr::findBoundMemberType ( const Expr * expr )

static

Given an expression of bound-member type, find the type of the member.

Returns null if this is an overloaded bound member expression.

Definition at line 2499 of file Expr.cpp.

References clang::Type::castAs(), hasPlaceholderType(), IgnoreParens(), clang::Type::isFunctionType(), and clang::ast_matchers::type.

Referenced by clang::CallExpr::getCallReturnType().

◆ getBestDynamicClassType()

const CXXRecordDecl * Expr::getBestDynamicClassType ( ) 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.

If this expression is a cast, this method looks through it to find the most derived decl that can be inferred from the expression. This is valid because derived-to-base conversions have undefined behavior if the object isn't dynamically of the derived type.

Definition at line 63 of file Expr.cpp.

References clang::Type::castAs(), clang::Type::getAs(), getBestDynamicClassTypeExpr(), clang::RecordType::getDecl(), clang::Type::getPointeeType(), getType(), and clang::Type::isDependentType().

Referenced by clang::CodeGen::CodeGenFunction::EmitCXXMemberOrOperatorMemberCallExpr(), and clang::CXXMethodDecl::getDevirtualizedMethod().

◆ getBestDynamicClassTypeExpr()

const Expr * Expr::getBestDynamicClassTypeExpr ( ) const

Get the inner expression that determines the best dynamic class.

If this is a prvalue, we guarantee that it is of the most-derived type for the object itself.

Definition at line 38 of file Expr.cpp.

References ignoreParenBaseCasts().

Referenced by getBestDynamicClassType(), and clang::CXXMethodDecl::getDevirtualizedMethod().

◆ getExprLoc()

SourceLocation Expr::getExprLoc ( ) const

getExprLoc - Return the preferred location for the arrow when diagnosing a problem with a generic expression.

Definition at line 216 of file Expr.cpp.

References clang::Stmt::getStmtClass(), and clang::Stmt::NoStmtClass.

◆ getObjCProperty()

const ObjCPropertyRefExpr * Expr::getObjCProperty ( ) const

If this expression is an l-value for an Objective C property, find the underlying property reference expression.

Definition at line 3520 of file Expr.cpp.

References getObjectKind(), getValueKind(), IgnoreParenCasts(), clang::OK_ObjCProperty, and clang::VK_LValue.

◆ getObjectKind()

ExprObjectKind clang::Expr::getObjectKind ( ) const

inline

getObjectKind - The object kind that this expression produces.

Object kinds are meaningful only for expressions that yield an l-value or x-value.

Definition at line 412 of file Expr.h.

◆ getReferencedDeclOfCallee() [1/2]

Decl * Expr::getReferencedDeclOfCallee ( )

Definition at line 1291 of file Expr.cpp.

References IgnoreParenCasts(), and IgnoreParenImpCasts().

Referenced by clang::CodeGen::CodeGenFunction::EmitCallee(), and clang::CallExpr::getCalleeDecl().

◆ getReferencedDeclOfCallee() [2/2]

const Decl* clang::Expr::getReferencedDeclOfCallee ( ) const

inline

Definition at line 453 of file Expr.h.

◆ getSourceBitField() [1/2]

FieldDecl * Expr::getSourceBitField ( )

If this expression refers to a bit-field, retrieve the declaration of that bit-field.

Note that this returns a non-null pointer in subtly different places than refersToBitField returns true. In particular, this can return a non-null pointer even for r-values loaded from bit-fields, but it will return null for a conditional bit-field.

Definition at line 3558 of file Expr.cpp.

References getSourceBitField(), IgnoreParens(), clang::FieldDecl::isBitField(), and clang::VK_RValue.

Referenced by AnalyzeAssignment(), GetExprRange(), getSourceBitField(), and clang::ASTContext::isPromotableBitField().

◆ getSourceBitField() [2/2]

const FieldDecl* clang::Expr::getSourceBitField ( ) const

inline

Definition at line 448 of file Expr.h.

◆ getType()

QualType clang::Expr::getType ( ) const

inline

Definition at line 128 of file Expr.h.

◆ getValueKind()

ExprValueKind clang::Expr::getValueKind ( ) const

inline

getValueKind - The value kind that this expression produces.

Definition at line 405 of file Expr.h.

◆ getValueKindForType()

static ExprValueKind clang::Expr::getValueKindForType ( QualType T )

inlinestatic

getValueKindForType - Given a formal return or parameter type, give its value kind.

Definition at line 395 of file Expr.h.

References clang::Type::getAs(), clang::VK_LValue, clang::VK_RValue, and clang::VK_XValue.

Referenced by EvaluateBinaryTypeTrait(), evaluateTypeTrait(), fixOverloadedReinterpretCastExpr(), clang::MemberExpr::getEndLoc(), clang::ASTContext::getInjectedTemplateArg(), and clang::TreeTransform< Derived >::RebuildShuffleVectorExpr().

◆ hasAnyTypeDependentArguments()

bool Expr::hasAnyTypeDependentArguments ( ArrayRef< Expr *> Exprs )

static

hasAnyTypeDependentArguments - Determines if any of the expressions in Exprs is type-dependent.

Definition at line 2849 of file Expr.cpp.

References isTypeDependent().

Referenced by clang::Sema::BuildCXXTypeConstructExpr(), clang::Sema::DeduceTemplateSpecializationFromInitializer(), clang::InitializationSequence::InitializeFrom(), and clang::Sema::ProduceCallSignatureHelp().

◆ hasNonTrivialCall()

bool Expr::hasNonTrivialCall ( const ASTContext & Ctx ) const

Determine whether this expression involves a call to any function that is not trivial.

Definition at line 3389 of file Expr.cpp.

Referenced by isTrivial().

◆ hasPlaceholderType() [1/2]

bool clang::Expr::hasPlaceholderType ( ) const

inline

Returns whether this expression has a placeholder type.

Definition at line 472 of file Expr.h.

Referenced by clang::Sema::ActOnConditionalOp(), clang::Sema::BuildInstanceMessage(), CheckArrow(), clang::Sema::CheckAssignmentOperands(), CheckForModifiableLvalue(), clang::Sema::checkUnknownAnyArg(), ClassifyBinaryOp(), clang::OverloadCandidateSet::clear(), clang::Sema::diagnoseARCUnbridgedCast(), findBoundMemberType(), clang::Sema::IgnoredValueConversions(), clang::Sema::PerformContextualImplicitConversion(), and clang::Sema::stripARCUnbridgedCast().

◆ hasPlaceholderType() [2/2]

bool clang::Expr::hasPlaceholderType ( BuiltinType::Kind K ) const

inline

Returns whether this expression has a specific placeholder type.

Definition at line 477 of file Expr.h.

References clang::BuiltinType::isPlaceholderTypeKind(), and clang::Result.

◆ HasSideEffects()

bool Expr::HasSideEffects	(	const ASTContext &	Ctx,
		bool	IncludePossibleEffects = `true`
	)		const

HasSideEffects - This routine returns true for all those expressions which have any effect other than producing a value.

Example is a function call, volatile variable read, or throwing an exception. If IncludePossibleEffects is false, this call treats certain expressions with potential side effects (such as function call-like expressions, instantiation-dependent expressions, or invocations from a macro) as not having side effects.

Definition at line 3064 of file Expr.cpp.

References getExprLoc(), clang::Stmt::getStmtClass(), clang::Decl::hasAttr(), isInstantiationDependent(), and clang::Stmt::NoStmtClass.

Referenced by clang::Sema::BuildCXXNoexceptExpr(), clang::Sema::BuildDecltypeType(), clang::Sema::CaptureHasSideEffects(), getDefaultBuiltinObjectSizeResult(), HandleConstructorCall(), clang::arcmt::trans::hasSideEffects(), clang::InitializationSequence::InitializeFrom(), isBlockVarRef(), clang::CallExpr::isBuiltinAssumeFalse(), isIdenticalStmt(), isTrivial(), and tryEvaluateBuiltinObjectSize().

◆ IgnoreCasts() [1/2]

Expr * Expr::IgnoreCasts ( )

Ignore casts. Strip off any CastExprs, returning their operand.

Definition at line 2580 of file Expr.cpp.

References P.

◆ IgnoreCasts() [2/2]

const Expr* clang::Expr::IgnoreCasts ( ) const

inline

Strip off casts, but keep parentheses.

Definition at line 830 of file Expr.h.

◆ IgnoreConversionOperator() [1/2]

Expr * Expr::IgnoreConversionOperator ( )

IgnoreConversionOperator - Ignore conversion operator.

If this Expr is a call to a conversion operator, return the argument.

Definition at line 2678 of file Expr.cpp.

Referenced by IsArithmeticBinaryExpr().

◆ IgnoreConversionOperator() [2/2]

const Expr* clang::Expr::IgnoreConversionOperator ( ) const

inline

Definition at line 776 of file Expr.h.

◆ IgnoreImpCasts() [1/2]

Expr * clang::Expr::IgnoreImpCasts ( )

inline

IgnoreImpCasts - Skip past any implicit casts which might surround this expression.

Only skips ImplicitCastExprs.

Definition at line 3103 of file Expr.h.

Referenced by addFixitForObjCARCConversion(), clang::arcmt::ObjCMigrateAction::BeginInvocation(), buildCaptureDecl(), clang::Sema::BuildMemberReferenceExpr(), castOperatorNeedsParens(), CheckFoldOperand(), CheckIdentityFieldAssignment(), CheckMemaccessSize(), CheckMoveOnConstruction(), checkOpenMPLoop(), CheckTemplateArgumentAddressOfObjectOrFunction(), CheckTemplateArgumentPointerToMember(), clang::Sema::DiagnoseAlwaysNonNullPointer(), DiagnoseForRangeReferenceVariableCopies(), diagnoseLogicalNotOnLHSofCheck(), diagnoseStringPlusChar(), diagnoseStringPlusInt(), doRewriteToUTF8StringBoxedExpressionHelper(), emitOMPAtomicCaptureExpr(), emitOMPAtomicUpdateExpr(), clang::CodeGen::CodeGenFunction::EmitOMPLinearClauseInit(), extractRegisterName(), GetNSSetArgumentIndex(), clang::Sema::InvalidLogicalVectorOperands(), IsArithmeticBinaryExpr(), isImplicitSelf(), requiresParensToAddCast(), rewriteToNumericBoxedExpression(), subscriptOperatorNeedsParens(), tryEvaluateBuiltinObjectSize(), and ValidDuplicateEnum().

◆ IgnoreImpCasts() [2/2]

const Expr* clang::Expr::IgnoreImpCasts ( ) const

inline

Definition at line 820 of file Expr.h.

◆ IgnoreImplicit() [1/2]

Expr* clang::Expr::IgnoreImplicit ( )

inline

IgnoreImplicit - Skip past any implicit AST nodes which might surround this expression.

Definition at line 747 of file Expr.h.

References clang::Stmt::IgnoreImplicit().

Referenced by CheckMoveOnConstruction(), CheckNonNullExpr(), clang::Sema::CodeCompleteCase(), DiagnoseConstAssignment(), clang::CodeGen::CGOpenCLRuntime::emitOpenCLEnqueuedBlock(), clang::BindingDecl::getHoldingVar(), getStaticBooleanValue(), clang::CXXConstructorDecl::getTargetConstructor(), IsCallableWithAppend(), IsReadonlyMessage(), clang::ento::ExprEngine::ProcessInitializer(), and clang::consumed::ConsumedStmtVisitor::VisitVarDecl().

◆ IgnoreImplicit() [2/2]

const Expr* clang::Expr::IgnoreImplicit ( ) const

inline

Definition at line 751 of file Expr.h.

◆ ignoreParenBaseCasts() [1/2]

Expr * Expr::ignoreParenBaseCasts ( )

Ignore parentheses and derived-to-base casts.

Definition at line 2635 of file Expr.cpp.

References IgnoreParens().

Referenced by getBestDynamicClassTypeExpr(), and clang::CXXInstanceCall::getExtraInvalidatedValues().

◆ ignoreParenBaseCasts() [2/2]

const Expr* clang::Expr::ignoreParenBaseCasts ( ) const

inline

Definition at line 800 of file Expr.h.

◆ IgnoreParenCasts() [1/2]

Expr * Expr::IgnoreParenCasts ( )

IgnoreParenCasts - Ignore parentheses and casts.

Strip off any ParenExpr or CastExprs, returning their operand.

Strip off any ParenExpr or CastExprs or ImplicitCastExprs, returning their operand.

Definition at line 2554 of file Expr.cpp.

References IgnoreParens(), and P.

Referenced by clang::Sema::CheckAdditionOperands(), checkBuiltinArgument(), checkFormatStringExpr(), CheckForModifiableLvalue(), CheckForNullPointerDereference(), CheckICE(), CheckIndirectionOperand(), checkMappableExpressionList(), checkObjCPointerIntrospection(), clang::Sema::checkStringLiteralArgumentAttr(), CheckTemplateArgumentAddressOfObjectOrFunction(), checkVAStartIsInVariadicFunction(), clang::Sema::CodeCompleteCase(), clang::Sema::DefaultFunctionArrayConversion(), diagnoseObjCLiteralComparison(), diagnoseTautologicalComparison(), EmitX86AddSubSatExpr(), findCapturingExpr(), FindTypeTagExpr(), getArgumentValueString(), getAsPointeeSymbol(), getBestPropertyDecl(), getIncrementedVar(), getLocationRegionIfReference(), getNSArrayObjects(), getObjCProperty(), getReferencedDeclOfCallee(), getStaticBooleanValue(), getStrlenExprArg(), HandleConstructorCall(), clang::arcmt::trans::hasSideEffects(), ignoreLiteralAdditions(), isCalleeArrow(), isCapturedBy(), isEnableIf(), clang::arcmt::trans::isGlobalVar(), isLeftShiftResultUnrepresentable(), clang::BinaryOperator::isNullPointerArithmeticExtension(), clang::arcmt::trans::isPlusOne(), clang::ASTContext::isSentinelNullExpr(), IsStandardConversion(), IsTailPaddedMemberArray(), isTrivialExpression(), isValidOrderingForOp(), LookThroughTransitiveAssignmentsAndCommaOperators(), LookupMemberExpr(), clang::sema::FunctionScopeInfo::markSafeWeakUse(), maybeAdjustInterfaceForSubscriptingCheck(), clang::TreeTransform< Derived >::RebuildCXXOperatorCallExpr(), REGISTER_MAP_WITH_PROGRAMSTATE(), RemoveSelectorFromWarningCache(), showBRDefaultDiagnostics(), and UseNSOptionsMacro().

◆ IgnoreParenCasts() [2/2]

const Expr* clang::Expr::IgnoreParenCasts ( ) const

inline

Definition at line 826 of file Expr.h.

◆ IgnoreParenImpCasts() [1/2]

Expr * Expr::IgnoreParenImpCasts ( )

IgnoreParenImpCasts - Ignore parentheses and implicit casts.

Strip off any ParenExpr or ImplicitCastExprs, returning their operand.

Definition at line 2652 of file Expr.cpp.

References IgnoreParens(), and P.

Referenced by clang::Sema::ActOnOpenMPAtomicDirective(), clang::Sema::ActOnOpenMPDeclareSimdDirective(), AnalyzeAssignment(), AnalyzeBitFieldAssignment(), AnalyzeComparison(), AnalyzeImplicitConversions(), clang::canCalleeThrow(), CheckBoolLikeConversion(), CheckConditionalOperand(), CheckConditionalOperator(), checkEnumComparison(), clang::Sema::CheckFloatComparison(), checkForLiteralCreation(), CheckForReference(), CheckICE(), CheckImplicitArgumentConversions(), CheckImplicitConversion(), clang::Sema::CheckLiteralKind(), checkMapClauseExpressionBase(), checkMapConflicts(), checkMappableExpressionList(), CheckMemaccessSize(), CheckMoveOnConstruction(), clang::Sema::CheckPlaceholderExpr(), clang::Sema::CheckShadowingDeclModification(), clang::Sema::CheckSubscriptingKind(), CheckTautologicalComparison(), checkUnsafeAssignLiteral(), ClassifyConditional(), ClassifyMemberExpr(), collectConjunctionTerms(), clang::Sema::ConversionToObjCStringLiteralCheck(), DiagnoseCallingConvCast(), DiagnoseConstAssignment(), DiagnoseCStringFormatDirectiveInCFAPI(), DiagnoseCStringFormatDirectiveInObjCAPI(), DiagnoseFloatingImpCast(), DiagnoseSelfAssignment(), clang::Sema::DiagnoseSelfMove(), diagnoseTautologicalComparison(), clang::Sema::diagnoseZeroToNullptrConversion(), doesExprLikelyComputeSize(), clang::CodeGen::emitDeclareSimdFunction(), emitInitWithReductionInitializer(), emitOMPArraySectionBase(), clang::CodeGen::CodeGenFunction::EmitOMPArraySectionExpr(), clang::Sema::EmitRelatedResultTypeNote(), clang::CodeGen::emitTaskInit(), ExprLooksBoolean(), clang::Sema::findFailedBooleanCondition(), FindTypeTagExpr(), getBaseDecl(), clang::OMPArraySectionExpr::getBaseOriginalType(), getBestPropertyDecl(), getDefaultBuiltinObjectSizeResult(), getPrivateItem(), getReferencedDeclOfCallee(), getSizeOfExprArg(), hasRecursiveCallInPath(), isCallToSelfClass(), isEnumConstant(), IsEnumConstOrFromMacro(), IsImplicitBoolFloatConversion(), isKnownToHaveUnsignedValue(), isObjCSelfExpr(), IsReadonlyMessage(), isSameWidthConstantConversion(), IsStdFunction(), clang::NSAPI::isSubclassOfNSClass(), IsTailPaddedMemberArray(), clang::CodeGen::CodeGenFunction::LoadPassedObjectSize(), lookThroughRangesV3Condition(), LookupMemberExpr(), clang::ento::ExprEngine::processSwitch(), recordFixedType(), refersToGlobalRegisterVar(), clang::Sema::RefersToMemberWithReducedAlignment(), clang::edit::rewriteObjCRedundantCallWithLiteral(), rewriteToNumberLiteral(), SemaBuiltinCpuIs(), SemaBuiltinCpuSupports(), stripCastsAndSugar(), tryNormalizeBinaryOperator(), and tryTransformToIntOrEnumConstant().

◆ IgnoreParenImpCasts() [2/2]

const Expr* clang::Expr::IgnoreParenImpCasts ( ) const

inline

Definition at line 780 of file Expr.h.

◆ IgnoreParenLValueCasts() [1/2]

Expr * Expr::IgnoreParenLValueCasts ( )

Ignore parentheses and lvalue casts.

IgnoreParenLValueCasts - Ignore parentheses and lvalue-to-rvalue casts.

Strip off any ParenExpr and CastExprs that represent lvalue casts, returning their operand.

This is intended purely as a temporary workaround for code that hasn't yet been rewritten to do the right thing about those casts, and may disappear along with the last internal use.

Definition at line 2609 of file Expr.cpp.

References IgnoreParens(), and P.

Referenced by checkMappableExpressionList(), getIncrementedVar(), and clang::Sema::isSelfExpr().

◆ IgnoreParenLValueCasts() [2/2]

const Expr* clang::Expr::IgnoreParenLValueCasts ( ) const

inline

Definition at line 788 of file Expr.h.

◆ IgnoreParenNoopCasts() [1/2]

Expr * Expr::IgnoreParenNoopCasts ( ASTContext & Ctx )

IgnoreParenNoopCasts - Ignore parentheses and casts that do not change the value (including ptr->int casts of the same size).

Strip off any ParenExpr or CastExprs, returning their operand.

Definition at line 2689 of file Expr.cpp.

References getType(), clang::ASTContext::getTypeSize(), clang::ASTContext::hasSameUnqualifiedType(), IgnoreParens(), clang::Type::isIntegralType(), clang::Type::isPointerType(), and P.

Referenced by AddVariableConstraints(), and stripCasts().

◆ IgnoreParenNoopCasts() [2/2]

const Expr* clang::Expr::IgnoreParenNoopCasts ( ASTContext & Ctx ) const

inline

Definition at line 834 of file Expr.h.

◆ IgnoreParens() [1/2]

Expr * Expr::IgnoreParens ( )

IgnoreParens - Ignore parentheses.

If this Expr is a ParenExpr, return its subexpression. If that subexpression is also a ParenExpr, then this method recursively returns its subexpression, and so forth. Otherwise, the method returns the current Expr.

Definition at line 2523 of file Expr.cpp.

References P.

Referenced by clang::ento::ProgramState::addPartialTaint(), buildFakeCtorCall(), clang::Sema::canThrow(), CheckMoveOnConstruction(), clang::Sema::CheckPlaceholderExpr(), clang::Sema::checkPseudoObjectRValue(), clang::Sema::checkUnknownAnyArg(), clang::Sema::checkUnsafeExprAssigns(), clang::Sema::CheckVecStepExpr(), ClassifyInternal(), ClassifyMemberExpr(), clang::Sema::completeExprArrayBound(), clang::ento::ExprEngine::CreateCXXTemporaryObject(), describeUninitializedArgumentInCall(), clang::Sema::diagnoseARCUnbridgedCast(), clang::Sema::DiagnoseEqualityWithExtraParens(), clang::Sema::DiscardMisalignedMemberAddress(), DoMarkVarDeclReferenced(), doRewriteToUTF8StringBoxedExpressionHelper(), clang::CodeGen::CodeGenFunction::EmitBranchOnBoolExpr(), clang::CodeGen::CodeGenFunction::EmitCallee(), clang::CodeGen::CodeGenFunction::EmitCXXMemberCallExpr(), clang::CodeGen::CodeGenFunction::EmitCXXMemberPointerCallExpr(), EmitLValueOrThrowExpression(), clang::CodeGen::CodeGenFunction::EmitPointerWithAlignment(), evaluateLValueAsAllocSize(), clang::OverloadExpr::find(), findBoundMemberType(), findEnumForBlockReturn(), findPeephole(), findRetainCycleOwner(), findWeakLValue(), GetAlignOfExpr(), getArrayIndexingBound(), clang::OMPArraySectionExpr::getBaseOriginalType(), clang::CallExpr::getCallReturnType(), clang::ento::SValBuilder::getConstantVal(), clang::Sema::getCopyElisionCandidate(), getDecltypeForExpr(), getExprAsWritten(), GetExprRange(), clang::CXXMemberCallExpr::getImplicitObjectArgument(), clang::CXXMemberCallExpr::getMethodDecl(), GetNumNonZeroBytesInInit(), getPrivateItem(), getReferenceInitTemporaryType(), getSelfInitExpr(), getSourceBitField(), clang::CFGBlock::getTerminatorCondition(), HandleConstructorCall(), clang::ento::ExprEngine::handleUOExtension(), IgnoreCommaOperand(), ignoreParenBaseCasts(), IgnoreParenCasts(), IgnoreParenImpCasts(), IgnoreParenLValueCasts(), IgnoreParenNoopCasts(), ignorePointerCastsAndParens(), ignoreTransparentExprs(), clang::InitializationSequence::InitializeFrom(), isBlockVarRef(), isCheapEnoughToEvaluateUnconditionally(), isFlexibleArrayMemberExpr(), isGLValueFromPointerDeref(), isInvalidICRSource(), isKnownToHaveBooleanValue(), IsModifiable(), isOBJCGCCandidate(), isOnePastTheEndOfCompleteObject(), isParenthesizedADLCallee(), isReferenceToNonConstCapture(), isSimpleZero(), IsSpecialDiscardedValue(), IsStandardConversion(), clang::InitListExpr::isStringLiteralInit(), clang::Sema::IsStringLiteralToNonConstPointerConversion(), isUnusedResultAWarning(), LookupMethodInReceiverType(), maybeGetUnaryAddrOfOperand(), refersToVectorElement(), shouldEmitSeparateBlockRetain(), shouldExtendReceiverForInnerPointerMessage(), clang::CodeGen::CodeGenFunction::ShouldNullCheckClassCastValue(), skipRValueSubobjectAdjustments(), skipTemporaryBindingsNoOpCastsAndParens(), tryEmitARCCopyWeakInit(), tryEmitARCRetainLoadOfScalar(), clang::Sema::tryExprAsCall(), tryTransformToIntOrEnumConstant(), clang::UnaryExprOrTypeTraitExpr::UnaryExprOrTypeTraitExpr(), clang::Sema::UpdateMarkingForLValueToRValue(), clang::ento::ExprEngine::VisitArraySubscriptExpr(), clang::ento::ExprEngine::VisitBinaryOperator(), clang::ento::ExprEngine::VisitGuardedExpr(), clang::ento::ExprEngine::VisitIncrementDecrementOperator(), visitLocalsRetainedByInitializer(), clang::ento::ExprEngine::VisitUnaryOperator(), and writeShouldKill().

◆ IgnoreParens() [2/2]

const Expr* clang::Expr::IgnoreParens ( ) const

inline

Definition at line 823 of file Expr.h.

◆ isBoundMemberFunction()

bool Expr::isBoundMemberFunction ( ASTContext & Ctx ) const

Returns true if this expression is a bound member function.

Definition at line 2493 of file Expr.cpp.

References ClassifyLValue(), isTypeDependent(), and LV_MemberFunction.

◆ isConstantInitializer()

bool Expr::isConstantInitializer	(	ASTContext &	Ctx,
		bool	ForRef,
		const Expr **	Culprit = `nullptr`
	)		const

isConstantInitializer - Returns true if this expression can be emitted to IR as a constant, and thus can be used as a constant initializer in C.

If this expression is not constant and Culprit is non-null, it is used to store the address of first non constant expr.

Definition at line 2857 of file Expr.cpp.

References EvaluateAsInt(), EvaluateAsLValue(), clang::RecordDecl::fields(), clang::CXXConstructExpr::getArg(), clang::Type::getAs(), clang::DesignatedInitUpdateExpr::getBase(), clang::CastExpr::getCastKind(), clang::CXXConstructExpr::getConstructor(), clang::InitListExpr::getInit(), clang::InitListExpr::getInitializedFieldInUnion(), clang::CXXConstructExpr::getNumArgs(), clang::InitListExpr::getNumInits(), clang::UnaryOperator::getOpcode(), clang::CXXMethodDecl::getParent(), clang::Stmt::getStmtClass(), clang::UnaryOperator::getSubExpr(), clang::CastExpr::getSubExpr(), getType(), clang::DesignatedInitUpdateExpr::getUpdater(), clang::Expr::EvalStatus::HasSideEffects, clang::CXXRecordDecl::hasTrivialDestructor(), clang::Type::isArrayType(), isConstantInitializer(), isEvaluatable(), clang::Type::isRecordType(), clang::FunctionDecl::isTrivial(), clang::TagDecl::isUnion(), clang::Result, and SE_AllowUndefinedBehavior.

Referenced by clang::Sema::checkAllowedCUDAInitializer(), clang::Sema::CheckCompleteVariableDeclaration(), clang::Sema::CheckForConstantInitializer(), clang::CodeGen::CodeGenFunction::EmitAutoVarAlloca(), clang::Sema::InstantiateVariableInitializer(), and isConstantInitializer().

◆ isCXX11ConstantExpr()

bool Expr::isCXX11ConstantExpr	(	const ASTContext &	Ctx,
		APValue *	Result = `nullptr`,
		SourceLocation *	Loc = `nullptr`
	)		const

isCXX11ConstantExpr - Return true if this expression is a constant expression in C++11.

Can only be used in C++.

Note: This does not perform the implicit conversions required by C++11 [expr.const]p5.

Definition at line 11470 of file ExprConstant.cpp.

References clang::ASTContext::getLangOpts().

Referenced by EvaluateCPlusPlus11IntegralConstantExpr(), and clang::StandardConversionSequence::getNarrowingKind().

◆ isCXX98IntegralConstantExpr()

bool Expr::isCXX98IntegralConstantExpr ( const ASTContext & Ctx ) const

isCXX98IntegralConstantExpr - Return true if this expression is an integral constant expression in C++98.

Can only be used in C++.

Definition at line 11466 of file ExprConstant.cpp.

References CheckICE().

Referenced by isNullPointerConstant().

◆ isDefaultArgument()

bool Expr::isDefaultArgument ( ) const

Determine whether this expression is a default function argument.

Default arguments are implicitly generated in the abstract syntax tree by semantic analysis for function calls, object constructions, etc. in C++. Default arguments are represented by CXXDefaultArgExpr nodes; this routine also looks through any implicit casts to determine whether the expression is a default argument.

Definition at line 2724 of file Expr.cpp.

Referenced by clang::TreeTransform< Derived >::DropCallArgument(), and clang::CXXConstructExpr::getEndLoc().

◆ isEvaluatable()

bool Expr::isEvaluatable	(	const ASTContext &	Ctx,
		SideEffectsKind	SEK = `SE_NoSideEffects`
	)		const

isEvaluatable - Call EvaluateAsRValue to see if this expression can be constant folded without side-effects, but discard the result.

isEvaluatable - Call EvaluateAsRValue to see if this expression can be constant folded, but discard the result.

Definition at line 10913 of file ExprConstant.cpp.

References EvaluateAsRValue(), hasUnacceptableSideEffect(), and clang::Result.

Referenced by EvaluateBuiltinConstantP(), isCheapEnoughToEvaluateUnconditionally(), isConstantInitializer(), and isTrivial().

◆ isGLValue()

bool clang::Expr::isGLValue ( ) const

inline

Definition at line 252 of file Expr.h.

References clang::VK_RValue.

◆ isImplicitCXXThis()

bool Expr::isImplicitCXXThis ( ) const

Whether this expression is an implicit reference to 'this' in C++.

Definition at line 2805 of file Expr.cpp.

References Paren.

Referenced by mangleAArch64VectorBase().

◆ isInstantiationDependent()

bool clang::Expr::isInstantiationDependent ( ) const

inline

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.

In the following example, the expression sizeof(sizeof(T() + T())) is instantiation-dependent (since it involves a template parameter T), but is neither type- nor value-dependent, since the type of the inner sizeof is known (std::size_t) and therefore the size of the outer sizeof is known.

template<typename T>
void f(T x, T y) {
  sizeof(sizeof(T() + T());
}

Definition at line 191 of file Expr.h.

◆ isIntegerConstantExpr() [1/2]

bool Expr::isIntegerConstantExpr	(	llvm::APSInt &	Result,
		const ASTContext &	Ctx,
		SourceLocation *	Loc = `nullptr`,
		bool	isEvaluated = `true`
	)		const

isIntegerConstantExpr - Return true if this expression is a valid integer constant expression, and, if so, return its value in Result.

If not a valid i-c-e, return false and fill in Loc (if specified) with the location of the invalid expression.

Note: This does not perform the implicit conversions required by C++11 [expr.const]p5.

Definition at line 11442 of file ExprConstant.cpp.

References EvaluateCPlusPlus11IntegralConstantExpr(), and clang::ASTContext::getLangOpts().

Referenced by clang::Sema::ActOnOpenMPDistScheduleClause(), clang::Sema::ActOnOpenMPLinearClause(), clang::Sema::ActOnOpenMPScheduleClause(), clang::Sema::ActOnPragmaPack(), AnalyzeComparison(), clang::Sema::BuildAddressSpaceAttr(), clang::Sema::BuildExtVectorType(), clang::Sema::CheckCaseExpression(), checkIntToPointerCast(), EmitAArch64TblBuiltinExpr(), clang::CodeGen::CodeGenFunction::EmitCommonNeonBuiltinExpr(), clang::CodeGen::CodeGenFunction::EmitX86BuiltinExpr(), fitsInto(), clang::StandardConversionSequence::getNarrowingKind(), HandleNeonVectorTypeAttr(), isNonNegativeIntegerValue(), isNullPointerConstant(), IsStandardConversion(), IsZeroInitializer(), clang::ASTContext::mergeTypes(), and TryOCLSamplerInitialization().

◆ isIntegerConstantExpr() [2/2]

bool Expr::isIntegerConstantExpr	(	const ASTContext &	Ctx,
		SourceLocation *	Loc = `nullptr`
	)		const

Definition at line 11429 of file ExprConstant.cpp.

References CheckICE(), EvaluateCPlusPlus11IntegralConstantExpr(), and clang::ASTContext::getLangOpts().

◆ isKnownToHaveBooleanValue()

bool Expr::isKnownToHaveBooleanValue ( ) const

isKnownToHaveBooleanValue - Return true if this is an integer expression that is known to return 0 or 1.

This happens for _Bool/bool expressions but also int expressions which are produced by things like comparisons in C.

Definition at line 135 of file Expr.cpp.

References clang::ast_matchers::expr, clang::Stmt::getBeginLoc(), getExprLoc(), getType(), IgnoreParens(), clang::Type::isBooleanType(), clang::Type::isIntegralOrEnumerationType(), and v.

Referenced by clang::Sema::ActOnStartOfSwitchStmt(), CheckTautologicalComparison(), and diagnoseLogicalNotOnLHSofCheck().

◆ isLValue()

bool clang::Expr::isLValue ( ) const

inline

isLValue - True if this expression is an "l-value" according to the rules of the current language.

C and C++ give somewhat different rules for this concept, but in general, the result of an l-value expression identifies a specific object whereas the result of an r-value expression is a value detached from any specific storage.

C++11 divides the concept of "r-value" into pure r-values ("pr-values") and so-called expiring values ("x-values"), which identify specific objects that can be safely cannibalized for their resources. This is an unfortunate abuse of terminology on the part of the C++ committee. In Clang, when we say "r-value", we generally mean a pr-value.

Definition at line 249 of file Expr.h.

References clang::VK_LValue.

Referenced by clang::Sema::ActOnOpenMPAtomicDirective(), AdjustFunctionParmAndArgTypesForDeduction(), checkMappableExpressionList(), ClassifyInternal(), emitOMPAtomicCaptureExpr(), emitOMPAtomicReadExpr(), emitOMPAtomicUpdateExpr(), emitOMPAtomicWriteExpr(), EvaluateExpressionTrait(), IsGlobalLValue(), clang::ento::ExplodedGraph::isInterestingLValueExpr(), isReferenceToNonConstCapture(), TryClassUnification(), TryLValueToRValueCast(), TryStaticReferenceDowncast(), and writeShouldKill().

◆ isModifiableLvalue()

Expr::isModifiableLvalueResult Expr::isModifiableLvalue	(	ASTContext &	Ctx,
		SourceLocation *	Loc = `nullptr`
	)		const

isModifiableLvalue - C99 6.3.2.1: an lvalue that does not have array type, does not have an incomplete type, does not have a const-qualified type, and if it is a structure or union, does not have any member (including, recursively, any member or element of all contained aggregates or unions) with a const-qualified type.

Parameters

Loc	[in,out] - A source location which may be filled in with the location of the expression making this a non-modifiable lvalue, if specified.

Definition at line 672 of file ExprClassification.cpp.

Referenced by CheckForModifiableLvalue().

◆ isNullPointerConstant()

Expr::NullPointerConstantKind Expr::isNullPointerConstant	(	ASTContext &	Ctx,
		NullPointerConstantValueDependence	NPC
	)		const

isNullPointerConstant - C99 6.3.2.3p3 - Test if this reduces down to a Null pointer constant.

isNullPointerConstant - C99 6.3.2.3p3 - Return whether this is a null pointer constant or not, as well as the specific kind of constant detected.

The return value can further distinguish the kind of NULL pointer constant that was detected.

Null pointer constants can be integer constant expressions with the value zero, casts of zero to void*, nullptr (C++0X), or __null (a GNU extension).

Definition at line 3401 of file Expr.cpp.

References clang::Qualifiers::empty(), EvaluateKnownConstInt(), clang::QualType::getAddressSpace(), clang::Type::getAs(), clang::ASTContext::getLangOpts(), clang::Type::getPointeeType(), clang::QualType::getQualifiers(), getType(), clang::APIntStorage::getValue(), isCXX98IntegralConstantExpr(), clang::Type::isEnumeralType(), isIntegerConstantExpr(), isNullPointerConstant(), isTypeDependent(), isValueDependent(), clang::Type::isVoidType(), NPC_NeverValueDependent, NPC_ValueDependentIsNotNull, NPC_ValueDependentIsNull, NPCK_CXX11_nullptr, NPCK_GNUNull, NPCK_NotNull, NPCK_ZeroExpression, NPCK_ZeroLiteral, clang::opencl_generic, clang::opencl_private, and clang::Qualifiers::removeAddressSpace().

Referenced by clang::Sema::BuildCXXUuidof(), clang::Sema::CheckAdditionOperands(), checkFormatStringExpr(), clang::Sema::CheckMemberPointerConversion(), clang::Sema::CheckPointerConversion(), clang::Sema::DiagnoseConditionalForNull(), DiagnoseNullConversion(), diagnoseObjCLiteralComparison(), diagnoseTautologicalComparison(), clang::Sema::FindCompositePointerType(), getAsPointeeSymbol(), clang::ento::SValBuilder::getConstantVal(), isInvalidICRSource(), clang::Sema::IsMemberPointerConversion(), clang::BinaryOperator::isNullPointerArithmeticExtension(), isNullPointerConstant(), isNullPointerValueTemplateArgument(), clang::ASTContext::isSentinelNullExpr(), SemaOpenCLBuiltinEnqueueKernel(), and tryEvaluateBuiltinObjectSize().

◆ isOBJCGCCandidate()

bool Expr::isOBJCGCCandidate ( ASTContext & Ctx ) const

isOBJCGCCandidate - Return true if this expression may be used in a read/ write barrier.

isOBJCGCCandidate - Check if an expression is objc gc'able.

returns true, if it is; false otherwise.

Definition at line 2454 of file Expr.cpp.

References clang::MemberExpr::getBase(), clang::ASTContext::getObjCGCAttrKind(), clang::Stmt::getStmtClass(), IgnoreParens(), isOBJCGCCandidate(), clang::Type::isPointerType(), and clang::Qualifiers::Weak.

Referenced by clang::CodeGen::CodeGenFunction::EmitArraySubscriptExpr(), clang::CodeGen::CodeGenFunction::EmitUnaryOpLValue(), and isOBJCGCCandidate().

◆ isObjCSelfExpr()

bool Expr::isObjCSelfExpr ( ) const

Check if this expression is the ObjC 'self' implicit parameter.

Definition at line 3540 of file Expr.cpp.

References clang::DeclRefExpr::getDecl(), clang::Decl::getDeclContext(), clang::ObjCMethodDecl::getSelfDecl(), and IgnoreParenImpCasts().

Referenced by getBestPropertyDecl().

◆ isOrdinaryOrBitFieldObject()

bool clang::Expr::isOrdinaryOrBitFieldObject ( ) const

inline

Definition at line 416 of file Expr.h.

References clang::OK_BitField, and clang::OK_Ordinary.

Referenced by clang::Sema::ActOnConditionalOp().

◆ isPotentialConstantExpr()

bool Expr::isPotentialConstantExpr	(	const FunctionDecl *	FD,
		SmallVectorImpl< PartialDiagnosticAt > &	Diags
	)

static

isPotentialConstantExpr - Return true if this function's definition might be usable in a constant expression in C++11, if it were marked constexpr.

Return false if the function can never produce a constant expression, along with diagnostics describing why not.

Definition at line 11534 of file ExprConstant.cpp.

References clang::DeclContext::isDependentContext().

Referenced by clang::Sema::CheckConstexprFunctionBody().

◆ isPotentialConstantExprUnevaluated()

bool Expr::isPotentialConstantExprUnevaluated	(	Expr *	E,
		const FunctionDecl *	FD,
		SmallVectorImpl< PartialDiagnosticAt > &	Diags
	)

static

isPotentialConstantExprUnevaluted - Return true if this expression might be usable in a constant expression in C++11 in an unevaluated context, if it were in function FD marked constexpr.

Return false if the function can never produce a constant expression, along with diagnostics describing why not.

Definition at line 11576 of file ExprConstant.cpp.

◆ isRValue()

bool clang::Expr::isRValue ( ) const

inline

Definition at line 250 of file Expr.h.

References clang::VK_RValue.

Referenced by buildFakeCtorCall(), clang::Sema::BuildMemberReferenceExpr(), CheckICE(), checkIndirectCopyRestoreSource(), CheckLiteralType(), CheckMoveOnConstruction(), clang::CodeGen::CodeGenFunction::EmitIgnoredExpr(), clang::CodeGen::CodeGenFunction::EmitObjCIsaExpr(), emitPseudoObjectExpr(), EvaluateArray(), EvaluateAsBooleanCondition(), EvaluateAtomic(), EvaluateComplex(), EvaluateExpressionTrait(), EvaluateFloat(), EvaluateInPlace(), EvaluateIntegerOrLValue(), EvaluateMemberPointer(), EvaluatePointer(), EvaluateRecord(), EvaluateTemporary(), EvaluateVector(), EvaluateVoid(), FastEvaluateAsRValue(), clang::Sema::FillInlineAsmIdentifierInfo(), clang::CXXMethodDecl::getDevirtualizedMethod(), HandleConstructorCall(), clang::Sema::IgnoredValueConversions(), ignorePointerCastsAndParens(), clang::Sema::ImpCastExprToType(), isOnePastTheEndOfCompleteObject(), clang::InitListExpr::isTransparent(), clang::Sema::MaybeBindToTemporary(), clang::Sema::TemporaryMaterializationConversion(), and TryListInitialization().

◆ isTemporaryObject()

bool Expr::isTemporaryObject	(	ASTContext &	C,
		const CXXRecordDecl *	TempTy
	)		const

Determine whether the result of this expression is a temporary object of the given class type.

isTemporaryObject - Determines if this expression produces a temporary of the given class type.

Definition at line 2763 of file Expr.cpp.

References Classify(), getType(), clang::ASTContext::getTypeDeclType(), clang::ASTContext::hasSameUnqualifiedType(), clang::Expr::Classification::isPRValue(), and skipTemporaryBindingsNoOpCastsAndParens().

Referenced by CopyObject(), and clang::CodeGen::CodeGenFunction::EmitCXXConstructExpr().

◆ isTypeDependent()

bool clang::Expr::isTypeDependent ( ) const

inline

isTypeDependent - Determines whether this expression is type-dependent (C++ [temp.dep.expr]), which means that its type could change from one template instantiation to the next.

For example, the expressions "x" and "x + y" are type-dependent in the following code, but "y" is not type-dependent:

template<typename T>
void add(T x, int y) {
  x + y;
}

Definition at line 167 of file Expr.h.

◆ isUnusedResultAWarning()

bool Expr::isUnusedResultAWarning	(	const Expr *&	WarnE,
		SourceLocation &	Loc,
		SourceRange &	R1,
		SourceRange &	R2,
		ASTContext &	Ctx
	)		const

isUnusedResultAWarning - Return true if this immediate expression should be warned about if the result is unused.

If so, fill in expr, location, and ranges with expr to warn on and source locations/ranges appropriate for a warning.

If so, fill in Loc and Ranges with location to warn on and the source range[s] to report with the warning.

Definition at line 2115 of file Expr.cpp.

References clang::CompoundStmt::body_back(), clang::CompoundStmt::body_empty(), clang::CallExpr::getArg(), clang::Type::getAsCXXRecordDecl(), clang::Stmt::getBeginLoc(), clang::InitListExpr::getBeginLoc(), clang::CallExpr::getCallee(), clang::CallExpr::getCalleeDecl(), clang::CallExpr::getCallReturnType(), clang::ASTContext::getCanonicalType(), clang::CastExpr::getCastKind(), clang::DeclRefExpr::getDecl(), clang::Stmt::getEndLoc(), getExprLoc(), clang::ASTContext::getLangOpts(), clang::BinaryOperator::getLHS(), clang::ConditionalOperator::getLHS(), clang::CStyleCastExpr::getLParenLoc(), clang::ObjCMessageExpr::getMethodDecl(), clang::ObjCMessageExpr::getMethodFamily(), clang::CallExpr::getNumArgs(), clang::UnaryOperator::getOpcode(), clang::BinaryOperator::getOpcode(), clang::CXXOperatorCallExpr::getOperator(), clang::CXXOperatorCallExpr::getOperatorLoc(), clang::UnaryOperator::getOperatorLoc(), clang::BinaryOperator::getOperatorLoc(), clang::BinaryOperator::getRHS(), clang::ConditionalOperator::getRHS(), clang::CXXOperatorCallExpr::getSourceRange(), clang::Stmt::getSourceRange(), clang::Stmt::getStmtClass(), clang::UnaryOperator::getSubExpr(), clang::CastExpr::getSubExpr(), clang::PseudoObjectExpr::getSyntacticForm(), getType(), clang::Type::hasAttr(), clang::FunctionDecl::hasUnusedResultAttr(), IgnoreParens(), clang::BinaryOperator::isAssignmentOp(), isGLValue(), clang::ObjCMessageExpr::isInstanceMessage(), clang::Type::isReferenceType(), isTypeDependent(), isUnusedResultAWarning(), clang::Type::isVoidType(), clang::QualType::isVolatileQualified(), Label, and clang::OMF_init.

Referenced by isUnusedResultAWarning().

◆ isValueDependent()

bool clang::Expr::isValueDependent ( ) const

inline

isValueDependent - Determines whether this expression is value-dependent (C++ [temp.dep.constexpr]).

For example, the array bound of "Chars" in the following example is value-dependent.

template<int Size, char (&Chars)[Size]> struct meta_string;

Definition at line 149 of file Expr.h.

◆ isXValue()

bool clang::Expr::isXValue ( ) const

inline

Definition at line 251 of file Expr.h.

References clang::VK_XValue.

Referenced by TryClassUnification(), and tryEmitARCRetainLoadOfScalar().

◆ refersToBitField()

bool clang::Expr::refersToBitField ( ) const

inline

Returns true if this expression is a gl-value that potentially refers to a bit-field.

In C++, whether a gl-value refers to a bitfield is essentially an aspect of the value-kind type system.

Definition at line 437 of file Expr.h.

References clang::OK_BitField.

Referenced by clang::Sema::BuildTypeofExprType(), clang::Sema::CreateUnaryExprOrTypeTraitExpr(), isNonReferenceableGLValue(), and TryReferenceInitializationCore().

◆ refersToGlobalRegisterVar()

bool Expr::refersToGlobalRegisterVar ( ) const

Returns whether this expression refers to a global register variable.

Definition at line 3631 of file Expr.cpp.

References IgnoreParenImpCasts(), and clang::SC_Register.

◆ refersToVectorElement()

bool Expr::refersToVectorElement ( ) const

Returns whether this expression refers to a vector element.

Definition at line 3605 of file Expr.cpp.

References getType(), IgnoreParens(), clang::Type::isVectorType(), refersToVectorElement(), and clang::VK_RValue.

Referenced by isNonReferenceableGLValue(), refersToVectorElement(), and TryReferenceInitializationCore().

◆ setContainsUnexpandedParameterPack()

void clang::Expr::setContainsUnexpandedParameterPack ( bool PP = true )

inline

Set the bit that describes whether this expression contains an unexpanded parameter pack.

Definition at line 220 of file Expr.h.

Referenced by clang::CUDAKernelCallExpr::setConfig(), and clang::MaterializeTemporaryExpr::setExtendingDecl().

◆ setInstantiationDependent()

void clang::Expr::setInstantiationDependent ( bool ID )

inline

Set whether this expression is instantiation-dependent or not.

Definition at line 196 of file Expr.h.

Referenced by clang::MemberExpr::Create(), clang::CUDAKernelCallExpr::setConfig(), clang::MaterializeTemporaryExpr::setExtendingDecl(), and clang::UnaryExprOrTypeTraitExpr::UnaryExprOrTypeTraitExpr().

◆ setObjectKind()

void clang::Expr::setObjectKind ( ExprObjectKind Cat )

inline

setObjectKind - Set the object kind produced by this expression.

Definition at line 425 of file Expr.h.

◆ setType()

void clang::Expr::setType ( QualType t )

inline

Definition at line 129 of file Expr.h.

References clang::QualType::isNull(), and clang::Type::isReferenceType().

Referenced by clang::Sema::completeExprArrayBound(), ConstructTransparentUnion(), clang::DesignatedInitUpdateExpr::DesignatedInitUpdateExpr(), clang::OverloadExpr::OverloadExpr(), clang::InitializationSequence::Perform(), resolveBuiltinNewDeleteOverload(), SemaBuiltinReserveRWPipe(), SemaOpenCLBuiltinToAddr(), updateStringLiteralType(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ setTypeDependent()

void clang::Expr::setTypeDependent ( bool TD )

inline

Set whether this expression is type-dependent or not.

Definition at line 170 of file Expr.h.

Referenced by clang::MemberExpr::Create().

◆ setValueDependent()

void clang::Expr::setValueDependent ( bool VD )

inline

Set whether this expression is value-dependent or not.

Definition at line 152 of file Expr.h.

Referenced by clang::MemberExpr::Create(), clang::MaterializeTemporaryExpr::setExtendingDecl(), and clang::UnaryExprOrTypeTraitExpr::UnaryExprOrTypeTraitExpr().

◆ setValueKind()

void clang::Expr::setValueKind ( ExprValueKind Cat )

inline

setValueKind - Set the value kind produced by this expression.

Definition at line 422 of file Expr.h.

Referenced by clang::InitializationSequence::Perform(), and removeLValueToRValueCast().

◆ skipRValueSubobjectAdjustments() [1/2]

const Expr * Expr::skipRValueSubobjectAdjustments	(	SmallVectorImpl< const Expr *> &	CommaLHS,
		SmallVectorImpl< SubobjectAdjustment > &	Adjustments
	)		const

Walk outwards from an expression we want to bind a reference to and find the expression whose lifetime needs to be extended.

Record the LHSs of comma expressions and adjustments needed along the path.

Definition at line 77 of file Expr.cpp.

References clang::Type::getAs(), getType(), IgnoreParens(), and clang::Type::isRecordType().

Referenced by clang::CodeGen::CodeGenFunction::EmitMaterializeTemporaryExpr(), clang::ento::ExprEngine::getInitialState(), getReferenceInitTemporaryType(), visitLocalsRetainedByInitializer(), and visitLocalsRetainedByReferenceBinding().

◆ skipRValueSubobjectAdjustments() [2/2]

const Expr* clang::Expr::skipRValueSubobjectAdjustments ( ) const

inline

Definition at line 860 of file Expr.h.

◆ tryEvaluateObjectSize()

bool Expr::tryEvaluateObjectSize	(	uint64_t &	Result,
		ASTContext &	Ctx,
		unsigned	Type
	)		const

If the current Expr is a pointer, this will try to statically determine the number of bytes available where the pointer is pointing.

Returns true if all of the above holds and we were able to figure out the size, false otherwise.

Parameters

Type	- How to evaluate the size of the Expr, as defined by the "type" parameter of __builtin_object_size

Definition at line 11600 of file ExprConstant.cpp.

Referenced by getDefaultBuiltinObjectSizeResult().

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

include/clang/AST/Expr.h
lib/AST/Expr.cpp
lib/AST/ExprClassification.cpp
lib/AST/ExprConstant.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ConstExprUsage

◆ isModifiableLvalueResult

◆ LValueClassification

◆ NullPointerConstantKind

◆ NullPointerConstantValueDependence

◆ SideEffectsKind

Constructor & Destructor Documentation

◆ Expr() [1/2]

◆ Expr() [2/2]

Member Function Documentation

◆ Classify()

◆ ClassifyLValue()

◆ ClassifyModifiable()

◆ classof()

◆ containsUnexpandedParameterPack()

◆ EvaluateAsBooleanCondition()

◆ EvaluateAsConstantExpr()

◆ EvaluateAsFloat()

◆ EvaluateAsInitializer()

◆ EvaluateAsInt()

◆ EvaluateAsLValue()

◆ EvaluateAsRValue()

◆ EvaluateForOverflow()

◆ EvaluateKnownConstInt()

◆ EvaluateKnownConstIntCheckOverflow()

◆ EvaluateWithSubstitution()

◆ findBoundMemberType()

◆ getBestDynamicClassType()

◆ getBestDynamicClassTypeExpr()

◆ getExprLoc()

◆ getObjCProperty()

◆ getObjectKind()

◆ getReferencedDeclOfCallee() [1/2]

◆ getReferencedDeclOfCallee() [2/2]

◆ getSourceBitField() [1/2]

◆ getSourceBitField() [2/2]

◆ getType()

◆ getValueKind()

◆ getValueKindForType()

◆ hasAnyTypeDependentArguments()

◆ hasNonTrivialCall()

◆ hasPlaceholderType() [1/2]

◆ hasPlaceholderType() [2/2]

◆ HasSideEffects()

◆ IgnoreCasts() [1/2]

◆ IgnoreCasts() [2/2]

◆ IgnoreConversionOperator() [1/2]

◆ IgnoreConversionOperator() [2/2]

◆ IgnoreImpCasts() [1/2]

◆ IgnoreImpCasts() [2/2]

◆ IgnoreImplicit() [1/2]

◆ IgnoreImplicit() [2/2]

◆ ignoreParenBaseCasts() [1/2]

◆ ignoreParenBaseCasts() [2/2]

◆ IgnoreParenCasts() [1/2]

◆ IgnoreParenCasts() [2/2]

◆ IgnoreParenImpCasts() [1/2]

◆ IgnoreParenImpCasts() [2/2]

◆ IgnoreParenLValueCasts() [1/2]

◆ IgnoreParenLValueCasts() [2/2]

◆ IgnoreParenNoopCasts() [1/2]

◆ IgnoreParenNoopCasts() [2/2]

◆ IgnoreParens() [1/2]

◆ IgnoreParens() [2/2]

◆ isBoundMemberFunction()

◆ isConstantInitializer()

◆ isCXX11ConstantExpr()

◆ isCXX98IntegralConstantExpr()

◆ isDefaultArgument()

◆ isEvaluatable()

◆ isGLValue()

◆ isImplicitCXXThis()