clang  8.0.0svn
Public Member Functions | Static Public Member Functions | Friends | List of all members
clang::DeclRefExpr Class Referencefinal

A reference to a declared variable, function, enum, etc. More...

#include "clang/AST/Expr.h"

Inheritance diagram for clang::DeclRefExpr:
Inheritance graph
[legend]
Collaboration diagram for clang::DeclRefExpr:
Collaboration graph
[legend]

Public Member Functions

 DeclRefExpr (ValueDecl *D, bool RefersToEnclosingVariableOrCapture, QualType T, ExprValueKind VK, SourceLocation L, const DeclarationNameLoc &LocInfo=DeclarationNameLoc())
 
ValueDeclgetDecl ()
 
const ValueDeclgetDecl () const
 
void setDecl (ValueDecl *NewD)
 
DeclarationNameInfo getNameInfo () const
 
SourceLocation getLocation () const
 
void setLocation (SourceLocation L)
 
SourceLocation getBeginLoc () const LLVM_READONLY
 
SourceLocation getEndLoc () const LLVM_READONLY
 
bool hasQualifier () const
 Determine whether this declaration reference was preceded by a C++ nested-name-specifier, e.g., N::foo. More...
 
NestedNameSpecifierLoc getQualifierLoc () const
 If the name was qualified, retrieves the nested-name-specifier that precedes the name, with source-location information. More...
 
NestedNameSpecifiergetQualifier () const
 If the name was qualified, retrieves the nested-name-specifier that precedes the name. More...
 
NamedDeclgetFoundDecl ()
 Get the NamedDecl through which this reference occurred. More...
 
const NamedDeclgetFoundDecl () const
 Get the NamedDecl through which this reference occurred. More...
 
bool hasTemplateKWAndArgsInfo () const
 
SourceLocation getTemplateKeywordLoc () const
 Retrieve the location of the template keyword preceding this name, if any. More...
 
SourceLocation getLAngleLoc () const
 Retrieve the location of the left angle bracket starting the explicit template argument list following the name, if any. More...
 
SourceLocation getRAngleLoc () const
 Retrieve the location of the right angle bracket ending the explicit template argument list following the name, if any. More...
 
bool hasTemplateKeyword () const
 Determines whether the name in this declaration reference was preceded by the template keyword. More...
 
bool hasExplicitTemplateArgs () const
 Determines whether this declaration reference was followed by an explicit template argument list. More...
 
void copyTemplateArgumentsInto (TemplateArgumentListInfo &List) const
 Copies the template arguments (if present) into the given structure. More...
 
const TemplateArgumentLocgetTemplateArgs () const
 Retrieve the template arguments provided as part of this template-id. More...
 
unsigned getNumTemplateArgs () const
 Retrieve the number of template arguments provided as part of this template-id. More...
 
ArrayRef< TemplateArgumentLoctemplate_arguments () const
 
bool hadMultipleCandidates () const
 Returns true if this expression refers to a function that was resolved from an overloaded set having size greater than 1. More...
 
void setHadMultipleCandidates (bool V=true)
 Sets the flag telling whether this expression refers to a function that was resolved from an overloaded set having size greater than 1. More...
 
bool refersToEnclosingVariableOrCapture () const
 Does this DeclRefExpr refer to an enclosing local or a captured variable? More...
 
child_range children ()
 
const_child_range children () const
 
- Public Member Functions inherited from clang::Expr
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...
 
FieldDeclgetSourceBitField ()
 If this expression refers to a bit-field, retrieve the declaration of that bit-field. More...
 
const FieldDeclgetSourceBitField () const
 
DeclgetReferencedDeclOfCallee ()
 
const DeclgetReferencedDeclOfCallee () 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 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) 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 (llvm::APSInt &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...
 
ExprIgnoreImpCasts () LLVM_READONLY
 IgnoreImpCasts - Skip past any implicit casts which might surround this expression. More...
 
ExprIgnoreImplicit () LLVM_READONLY
 IgnoreImplicit - Skip past any implicit AST nodes which might surround this expression. More...
 
const ExprIgnoreImplicit () const LLVM_READONLY
 
ExprIgnoreParens () LLVM_READONLY
 IgnoreParens - Ignore parentheses. More...
 
ExprIgnoreParenCasts () LLVM_READONLY
 IgnoreParenCasts - Ignore parentheses and casts. More...
 
ExprIgnoreCasts () LLVM_READONLY
 Ignore casts. Strip off any CastExprs, returning their operand. More...
 
ExprIgnoreParenImpCasts () LLVM_READONLY
 IgnoreParenImpCasts - Ignore parentheses and implicit casts. More...
 
ExprIgnoreConversionOperator () LLVM_READONLY
 IgnoreConversionOperator - Ignore conversion operator. More...
 
const ExprIgnoreConversionOperator () const LLVM_READONLY
 
const ExprIgnoreParenImpCasts () const LLVM_READONLY
 
ExprIgnoreParenLValueCasts () LLVM_READONLY
 Ignore parentheses and lvalue casts. More...
 
const ExprIgnoreParenLValueCasts () const LLVM_READONLY
 
ExprIgnoreParenNoopCasts (ASTContext &Ctx) LLVM_READONLY
 IgnoreParenNoopCasts - Ignore parentheses and casts that do not change the value (including ptr->int casts of the same size). More...
 
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 ExprgetBestDynamicClassTypeExpr () const
 Get the inner expression that determines the best dynamic class. More...
 
const ExprskipRValueSubobjectAdjustments (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 ExprskipRValueSubobjectAdjustments () 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...
 
StmtIgnoreImplicit ()
 Skip past any implicit AST nodes which might surround this statement, such as ExprWithCleanups or ImplicitCastExpr nodes. More...
 
const StmtIgnoreImplicit () const
 
StmtIgnoreContainers (bool IgnoreCaptured=false)
 Skip no-op (attributed, compound) container stmts and skip captured stmt at the top, if IgnoreCaptured is true. More...
 
const StmtIgnoreContainers (bool IgnoreCaptured=false) const
 
const StmtstripLabelLikeStatements () const
 Strip off all label-like statements. More...
 
StmtstripLabelLikeStatements ()
 
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 DeclRefExprCreate (const ASTContext &Context, NestedNameSpecifierLoc QualifierLoc, SourceLocation TemplateKWLoc, ValueDecl *D, bool RefersToEnclosingVariableOrCapture, SourceLocation NameLoc, QualType T, ExprValueKind VK, NamedDecl *FoundD=nullptr, const TemplateArgumentListInfo *TemplateArgs=nullptr)
 
static DeclRefExprCreate (const ASTContext &Context, NestedNameSpecifierLoc QualifierLoc, SourceLocation TemplateKWLoc, ValueDecl *D, bool RefersToEnclosingVariableOrCapture, const DeclarationNameInfo &NameInfo, QualType T, ExprValueKind VK, NamedDecl *FoundD=nullptr, const TemplateArgumentListInfo *TemplateArgs=nullptr)
 
static DeclRefExprCreateEmpty (const ASTContext &Context, bool HasQualifier, bool HasFoundDecl, bool HasTemplateKWAndArgsInfo, unsigned NumTemplateArgs)
 Construct an empty declaration reference expression. More...
 
static bool classof (const Stmt *T)
 
- Static Public Member Functions inherited from clang::Expr
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 ()
 

Friends

class ASTStmtReader
 
class ASTStmtWriter
 

Additional Inherited Members

- 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_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 >
 
- Protected Types inherited from clang::Stmt
enum  { NumStmtBits = 8 }
 
enum  { NumExprBits = NumStmtBits + 9 }
 
enum  APFloatSemantics {
  IEEEhalf, IEEEsingle, IEEEdouble, x87DoubleExtended,
  IEEEquad, PPCDoubleDouble
}
 
- 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...
 
- 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...
 
- 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
 
   CallExprBitfields   CallExprBits
 
   MemberExprBitfields   MemberExprBits
 
   CastExprBitfields   CastExprBits
 
   BinaryOperatorBitfields   BinaryOperatorBits
 
   InitListExprBitfields   InitListExprBits
 
   PseudoObjectExprBitfields   PseudoObjectExprBits
 
   CXXBoolLiteralExprBitfields   CXXBoolLiteralExprBits
 
   CXXNullPtrLiteralExprBitfields   CXXNullPtrLiteralExprBits
 
   CXXThisExprBitfields   CXXThisExprBits
 
   CXXThrowExprBitfields   CXXThrowExprBits
 
   CXXDefaultArgExprBitfields   CXXDefaultArgExprBits
 
   CXXDefaultInitExprBitfields   CXXDefaultInitExprBits
 
   TypeTraitExprBitfields   TypeTraitExprBits
 
   ExprWithCleanupsBitfields   ExprWithCleanupsBits
 
   CoawaitExprBitfields   CoawaitBits
 
   ObjCIndirectCopyRestoreExprBitfields   ObjCIndirectCopyRestoreExprBits
 
   OpaqueValueExprBitfields   OpaqueValueExprBits
 
}; 
 

Detailed Description

A reference to a declared variable, function, enum, etc.

[C99 6.5.1p2]

This encodes all the information about how a declaration is referenced within an expression.

There are several optional constructs attached to DeclRefExprs only when they apply in order to conserve memory. These are laid out past the end of the object, and flags in the DeclRefExprBitfield track whether they exist:

DeclRefExprBits.HasQualifier: Specifies when this declaration reference expression has a C++ nested-name-specifier. DeclRefExprBits.HasFoundDecl: Specifies when this declaration reference expression has a record of a NamedDecl (different from the referenced ValueDecl) which was found during name lookup and/or overload resolution. DeclRefExprBits.HasTemplateKWAndArgsInfo: Specifies when this declaration reference expression has an explicit C++ template keyword and/or template argument list. DeclRefExprBits.RefersToEnclosingVariableOrCapture Specifies when this declaration reference expression (validly) refers to an enclosed local or a captured variable.

Definition at line 1036 of file Expr.h.

Constructor & Destructor Documentation

◆ DeclRefExpr()

clang::DeclRefExpr::DeclRefExpr ( ValueDecl D,
bool  RefersToEnclosingVariableOrCapture,
QualType  T,
ExprValueKind  VK,
SourceLocation  L,
const DeclarationNameLoc LocInfo = DeclarationNameLoc() 
)
inline

Definition at line 1083 of file Expr.h.

References clang::Create(), and clang::Decl::getASTContext().

Member Function Documentation

◆ children() [1/2]

child_range clang::DeclRefExpr::children ( )
inline

Definition at line 1253 of file Expr.h.

◆ children() [2/2]

const_child_range clang::DeclRefExpr::children ( ) const
inline

Definition at line 1257 of file Expr.h.

◆ classof()

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

Definition at line 1248 of file Expr.h.

References clang::Stmt::getStmtClass().

◆ copyTemplateArgumentsInto()

void clang::DeclRefExpr::copyTemplateArgumentsInto ( TemplateArgumentListInfo List) const
inline

Copies the template arguments (if present) into the given structure.

Definition at line 1204 of file Expr.h.

◆ Create() [1/2]

DeclRefExpr * DeclRefExpr::Create ( const ASTContext Context,
NestedNameSpecifierLoc  QualifierLoc,
SourceLocation  TemplateKWLoc,
ValueDecl D,
bool  RefersToEnclosingVariableOrCapture,
SourceLocation  NameLoc,
QualType  T,
ExprValueKind  VK,
NamedDecl FoundD = nullptr,
const TemplateArgumentListInfo TemplateArgs = nullptr 
)
static

◆ Create() [2/2]

DeclRefExpr * DeclRefExpr::Create ( const ASTContext Context,
NestedNameSpecifierLoc  QualifierLoc,
SourceLocation  TemplateKWLoc,
ValueDecl D,
bool  RefersToEnclosingVariableOrCapture,
const DeclarationNameInfo NameInfo,
QualType  T,
ExprValueKind  VK,
NamedDecl FoundD = nullptr,
const TemplateArgumentListInfo TemplateArgs = nullptr 
)
static

Definition at line 408 of file Expr.cpp.

◆ CreateEmpty()

DeclRefExpr * DeclRefExpr::CreateEmpty ( const ASTContext Context,
bool  HasQualifier,
bool  HasFoundDecl,
bool  HasTemplateKWAndArgsInfo,
unsigned  NumTemplateArgs 
)
static

Construct an empty declaration reference expression.

Definition at line 436 of file Expr.cpp.

◆ getBeginLoc()

SourceLocation DeclRefExpr::getBeginLoc ( ) const

◆ getDecl() [1/2]

ValueDecl* clang::DeclRefExpr::getDecl ( )
inline

Definition at line 1119 of file Expr.h.

Referenced by clang::Sema::ActOnOpenMPLinearClause(), clang::Sema::ActOnOpenMPLoopInitialization(), clang::Sema::ActOnOpenMPThreadprivateDirective(), AddVariableConstraints(), checkBuiltinArgument(), checkFormatStringExpr(), CheckForModifiableLvalue(), CheckIdentityFieldAssignment(), CheckMoveOnConstruction(), CheckTemplateArgumentAddressOfObjectOrFunction(), CheckTemplateArgumentPointerToMember(), DiagnoseSelfAssignment(), clang::Sema::DiagnoseSelfMove(), dumpBasePath(), clang::CodeGen::CodeGenFunction::EmitDeclRefExprDbgValue(), clang::CodeGen::CodeGenFunction::EmitDeclRefLValue(), EmitOMPHelperVar(), clang::CodeGen::emitSingleReductionCombiner(), EvaluateLValue(), FindTypeTagExpr(), getBaseDecl(), clang::CallExpr::getBuiltinCallee(), clang::Sema::getCopyElisionCandidate(), getIncrementedVar(), clang::arcmt::trans::getNilString(), isEnumConstant(), isIdenticalStmt(), clang::Expr::isObjCSelfExpr(), isPointerToConst(), isReferenceToNonConstCapture(), clang::Expr::isUnusedResultAWarning(), LookThroughTransitiveAssignmentsAndCommaOperators(), mapParam(), clang::Sema::MarkDeclRefReferenced(), MarkUsedTemplateParameters(), RecordModifiableNonNullParam(), shouldExtendReceiverForInnerPointerMessage(), clang::TreeTransform< Derived >::TransformOMPExecutableDirective(), clang::CodeGen::CodeGenFunction::tryEmitAsConstant(), ValidDuplicateEnum(), clang::consumed::ConsumedStmtVisitor::VisitDeclRefExpr(), clang::ASTNodeImporter::VisitDeclRefExpr(), and writeShouldKill().

◆ getDecl() [2/2]

const ValueDecl* clang::DeclRefExpr::getDecl ( ) const
inline

Definition at line 1120 of file Expr.h.

◆ getEndLoc()

SourceLocation DeclRefExpr::getEndLoc ( ) const

◆ getFoundDecl() [1/2]

NamedDecl* clang::DeclRefExpr::getFoundDecl ( )
inline

Get the NamedDecl through which this reference occurred.

This Decl may be different from the ValueDecl actually referred to in the presence of using declarations, etc. It always returns non-NULL, and may simple return the ValueDecl when appropriate.

Definition at line 1156 of file Expr.h.

Referenced by dumpBasePath(), clang::tooling::RecursiveSymbolVisitor< T >::VisitDeclRefExpr(), and clang::ASTNodeImporter::VisitDeclRefExpr().

◆ getFoundDecl() [2/2]

const NamedDecl* clang::DeclRefExpr::getFoundDecl ( ) const
inline

Get the NamedDecl through which this reference occurred.

See non-const variant.

Definition at line 1162 of file Expr.h.

◆ getLAngleLoc()

SourceLocation clang::DeclRefExpr::getLAngleLoc ( ) const
inline

Retrieve the location of the left angle bracket starting the explicit template argument list following the name, if any.

Definition at line 1180 of file Expr.h.

Referenced by clang::TreeTransform< Derived >::TransformOMPExecutableDirective().

◆ getLocation()

SourceLocation clang::DeclRefExpr::getLocation ( ) const
inline

◆ getNameInfo()

DeclarationNameInfo clang::DeclRefExpr::getNameInfo ( ) const
inline

◆ getNumTemplateArgs()

unsigned clang::DeclRefExpr::getNumTemplateArgs ( ) const
inline

Retrieve the number of template arguments provided as part of this template-id.

Definition at line 1220 of file Expr.h.

Referenced by clang::TreeTransform< Derived >::TransformOMPExecutableDirective().

◆ getQualifier()

NestedNameSpecifier* clang::DeclRefExpr::getQualifier ( ) const
inline

If the name was qualified, retrieves the nested-name-specifier that precedes the name.

Otherwise, returns NULL.

Definition at line 1146 of file Expr.h.

Referenced by CheckTemplateArgumentPointerToMember().

◆ getQualifierLoc()

NestedNameSpecifierLoc clang::DeclRefExpr::getQualifierLoc ( ) const
inline

If the name was qualified, retrieves the nested-name-specifier that precedes the name, with source-location information.

Definition at line 1138 of file Expr.h.

Referenced by clang::TreeTransform< Derived >::TransformOMPExecutableDirective(), and clang::ASTNodeImporter::VisitDeclRefExpr().

◆ getRAngleLoc()

SourceLocation clang::DeclRefExpr::getRAngleLoc ( ) const
inline

Retrieve the location of the right angle bracket ending the explicit template argument list following the name, if any.

Definition at line 1188 of file Expr.h.

Referenced by clang::TreeTransform< Derived >::TransformOMPExecutableDirective().

◆ getTemplateArgs()

const TemplateArgumentLoc* clang::DeclRefExpr::getTemplateArgs ( ) const
inline

Retrieve the template arguments provided as part of this template-id.

Definition at line 1212 of file Expr.h.

Referenced by clang::TreeTransform< Derived >::TransformOMPExecutableDirective().

◆ getTemplateKeywordLoc()

SourceLocation clang::DeclRefExpr::getTemplateKeywordLoc ( ) const
inline

Retrieve the location of the template keyword preceding this name, if any.

Definition at line 1172 of file Expr.h.

Referenced by clang::ASTNodeImporter::VisitDeclRefExpr().

◆ hadMultipleCandidates()

bool clang::DeclRefExpr::hadMultipleCandidates ( ) const
inline

Returns true if this expression refers to a function that was resolved from an overloaded set having size greater than 1.

Definition at line 1232 of file Expr.h.

Referenced by clang::ASTNodeImporter::VisitDeclRefExpr().

◆ hasExplicitTemplateArgs()

bool clang::DeclRefExpr::hasExplicitTemplateArgs ( ) const
inline

Determines whether this declaration reference was followed by an explicit template argument list.

Definition at line 1200 of file Expr.h.

Referenced by clang::TreeTransform< Derived >::TransformOMPExecutableDirective(), and clang::ASTNodeImporter::VisitDeclRefExpr().

◆ hasQualifier()

bool clang::DeclRefExpr::hasQualifier ( ) const
inline

Determine whether this declaration reference was preceded by a C++ nested-name-specifier, e.g., N::foo.

Definition at line 1134 of file Expr.h.

◆ hasTemplateKeyword()

bool clang::DeclRefExpr::hasTemplateKeyword ( ) const
inline

Determines whether the name in this declaration reference was preceded by the template keyword.

Definition at line 1196 of file Expr.h.

◆ hasTemplateKWAndArgsInfo()

bool clang::DeclRefExpr::hasTemplateKWAndArgsInfo ( ) const
inline

Definition at line 1166 of file Expr.h.

◆ refersToEnclosingVariableOrCapture()

bool clang::DeclRefExpr::refersToEnclosingVariableOrCapture ( ) const
inline

◆ setDecl()

void clang::DeclRefExpr::setDecl ( ValueDecl NewD)
inline

Definition at line 1121 of file Expr.h.

◆ setHadMultipleCandidates()

void clang::DeclRefExpr::setHadMultipleCandidates ( bool  V = true)
inline

Sets the flag telling whether this expression refers to a function that was resolved from an overloaded set having size greater than 1.

Definition at line 1238 of file Expr.h.

Referenced by clang::ASTNodeImporter::VisitDeclRefExpr().

◆ setLocation()

void clang::DeclRefExpr::setLocation ( SourceLocation  L)
inline

Definition at line 1128 of file Expr.h.

◆ template_arguments()

ArrayRef<TemplateArgumentLoc> clang::DeclRefExpr::template_arguments ( ) const
inline

Definition at line 1226 of file Expr.h.

Referenced by clang::ASTNodeImporter::VisitDeclRefExpr().

Friends And Related Function Documentation

◆ ASTStmtReader

friend class ASTStmtReader
friend

Definition at line 1041 of file Expr.h.

◆ ASTStmtWriter

friend class ASTStmtWriter
friend

Definition at line 1042 of file Expr.h.


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