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

Describes an C or C++ initializer list. More...

#include <Expr.h>

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

Public Types

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

Public Member Functions

 InitListExpr (const ASTContext &C, SourceLocation lbraceloc, ArrayRef< Expr * > initExprs, SourceLocation rbraceloc)
 
 InitListExpr (EmptyShell Empty)
 Build an empty initializer list. More...
 
unsigned getNumInits () const
 
Expr ** getInits ()
 Retrieve the set of initializers. More...
 
const ExprgetInit (unsigned Init) const
 
ExprgetInit (unsigned Init)
 
void setInit (unsigned Init, Expr *expr)
 
void reserveInits (const ASTContext &C, unsigned NumInits)
 Reserve space for some number of initializers. More...
 
void resizeInits (const ASTContext &Context, unsigned NumInits)
 Specify the number of initializers. More...
 
ExprupdateInit (const ASTContext &C, unsigned Init, Expr *expr)
 Updates the initializer at index Init with the new expression expr, and returns the old expression at that location. More...
 
ExprgetArrayFiller ()
 If this initializer list initializes an array with more elements than there are initializers in the list, specifies an expression to be used for value initialization of the rest of the elements. More...
 
const ExprgetArrayFiller () const
 
void setArrayFiller (Expr *filler)
 
bool hasArrayFiller () const
 Return true if this is an array initializer and its array "filler" has been set. More...
 
FieldDeclgetInitializedFieldInUnion ()
 If this initializes a union, specifies which field in the union to initialize. More...
 
const FieldDeclgetInitializedFieldInUnion () const
 
void setInitializedFieldInUnion (FieldDecl *FD)
 
bool isExplicit ()
 
bool isStringLiteralInit () const
 
SourceLocation getLBraceLoc () const
 
void setLBraceLoc (SourceLocation Loc)
 
SourceLocation getRBraceLoc () const
 
void setRBraceLoc (SourceLocation Loc)
 
bool isSemanticForm () const
 
InitListExprgetSemanticForm () const
 
InitListExprgetSyntacticForm () const
 
void setSyntacticForm (InitListExpr *Init)
 
bool hadArrayRangeDesignator () const
 
void sawArrayRangeDesignator (bool ARD=true)
 
SourceLocation getLocStart () const LLVM_READONLY
 
SourceLocation getLocEnd () const LLVM_READONLY
 
child_range children ()
 
iterator begin ()
 
const_iterator begin () const
 
iterator end ()
 
const_iterator end () const
 
reverse_iterator rbegin ()
 
const_reverse_iterator rbegin () const
 
reverse_iterator rend ()
 
const_reverse_iterator rend () const
 
- Public Member Functions inherited from clang::Expr
QualType getType () const
 
void setType (QualType t)
 
bool isValueDependent () const
 
void setValueDependent (bool VD)
 Set whether this expression is value-dependent or not. More...
 
bool isTypeDependent () const
 
void setTypeDependent (bool TD)
 Set whether this expression is type-dependent or not. More...
 
bool isInstantiationDependent () const
 Whether this expression is instantiation-dependent, meaning that it depends in some way on a template parameter, even if neither its type nor (constant) value can change due to the template instantiation. More...
 
void setInstantiationDependent (bool ID)
 Set whether this expression is instantiation-dependent or not. More...
 
bool containsUnexpandedParameterPack () const
 Whether this expression contains an unexpanded parameter pack (for C++11 variadic templates). More...
 
void setContainsUnexpandedParameterPack (bool PP=true)
 Set the bit that describes whether this expression contains an unexpanded parameter pack. More...
 
SourceLocation getExprLoc () const LLVM_READONLY
 
bool isUnusedResultAWarning (const Expr *&WarnExpr, SourceLocation &Loc, SourceRange &R1, SourceRange &R2, ASTContext &Ctx) const
 
bool isLValue () const
 
bool isRValue () const
 
bool isXValue () const
 
bool isGLValue () const
 
LValueClassification ClassifyLValue (ASTContext &Ctx) const
 Reasons why an expression might not be an l-value. More...
 
isModifiableLvalueResult isModifiableLvalue (ASTContext &Ctx, SourceLocation *Loc=nullptr) const
 
Classification Classify (ASTContext &Ctx) const
 Classify - Classify this expression according to the C++11 expression taxonomy. More...
 
Classification ClassifyModifiable (ASTContext &Ctx, SourceLocation &Loc) const
 ClassifyModifiable - Classify this expression according to the C++11 expression taxonomy, and see if it is valid on the left side of an assignment. More...
 
ExprValueKind getValueKind () const
 getValueKind - The value kind that this expression produces. More...
 
ExprObjectKind getObjectKind () const
 
bool isOrdinaryOrBitFieldObject () const
 
void setValueKind (ExprValueKind Cat)
 setValueKind - Set the value kind produced by this expression. More...
 
void setObjectKind (ExprObjectKind Cat)
 setObjectKind - Set the object kind produced by this expression. More...
 
bool refersToBitField () const
 Returns true if this expression is a gl-value that potentially refers to a bit-field. More...
 
FieldDeclgetSourceBitField ()
 If this expression refers to a bit-field, retrieve the declaration of that bit-field. More...
 
const FieldDeclgetSourceBitField () const
 
const ObjCPropertyRefExprgetObjCProperty () const
 If this expression is an l-value for an Objective C property, find the underlying property reference expression. More...
 
bool isObjCSelfExpr () const
 Check if this expression is the ObjC 'self' implicit parameter. More...
 
bool refersToVectorElement () const
 Returns whether this expression refers to a vector element. More...
 
bool hasPlaceholderType () const
 Returns whether this expression has a placeholder type. More...
 
bool hasPlaceholderType (BuiltinType::Kind K) const
 Returns whether this expression has a specific placeholder type. More...
 
bool isKnownToHaveBooleanValue () const
 
bool isIntegerConstantExpr (llvm::APSInt &Result, const ASTContext &Ctx, SourceLocation *Loc=nullptr, bool isEvaluated=true) const
 
bool isIntegerConstantExpr (const ASTContext &Ctx, SourceLocation *Loc=nullptr) const
 
bool isCXX98IntegralConstantExpr (const ASTContext &Ctx) const
 
bool isCXX11ConstantExpr (const ASTContext &Ctx, APValue *Result=nullptr, SourceLocation *Loc=nullptr) const
 
bool isConstantInitializer (ASTContext &Ctx, bool ForRef, const Expr **Culprit=nullptr) const
 
bool EvaluateAsRValue (EvalResult &Result, const ASTContext &Ctx) const
 
bool EvaluateAsBooleanCondition (bool &Result, const ASTContext &Ctx) const
 
bool EvaluateAsInt (llvm::APSInt &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
 
bool isEvaluatable (const ASTContext &Ctx) const
 
bool HasSideEffects (const ASTContext &Ctx, bool IncludePossibleEffects=true) const
 
bool hasNonTrivialCall (const ASTContext &Ctx) const
 Determine whether this expression involves a call to any function that is not trivial. More...
 
llvm::APSInt EvaluateKnownConstInt (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const
 
void EvaluateForOverflow (const ASTContext &Ctx) const
 
bool EvaluateAsLValue (EvalResult &Result, const ASTContext &Ctx) const
 
bool EvaluateAsInitializer (APValue &Result, const ASTContext &Ctx, const VarDecl *VD, SmallVectorImpl< PartialDiagnosticAt > &Notes) const
 
bool EvaluateWithSubstitution (APValue &Value, ASTContext &Ctx, const FunctionDecl *Callee, ArrayRef< const Expr * > Args) const
 
NullPointerConstantKind isNullPointerConstant (ASTContext &Ctx, NullPointerConstantValueDependence NPC) const
 
bool isOBJCGCCandidate (ASTContext &Ctx) const
 
bool isBoundMemberFunction (ASTContext &Ctx) const
 Returns true if this expression is a bound member function. More...
 
ExprIgnoreImpCasts () LLVM_READONLY
 
ExprIgnoreImplicit () LLVM_READONLY
 
const ExprIgnoreImplicit () const LLVM_READONLY
 
ExprIgnoreParens () LLVM_READONLY
 
ExprIgnoreParenCasts () LLVM_READONLY
 
ExprIgnoreCasts () LLVM_READONLY
 Ignore casts. Strip off any CastExprs, returning their operand. More...
 
ExprIgnoreParenImpCasts () LLVM_READONLY
 
ExprIgnoreConversionOperator () LLVM_READONLY
 
const ExprIgnoreConversionOperator () const LLVM_READONLY
 
const ExprIgnoreParenImpCasts () const LLVM_READONLY
 
ExprIgnoreParenLValueCasts () LLVM_READONLY
 
const ExprIgnoreParenLValueCasts () const LLVM_READONLY
 
ExprIgnoreParenNoopCasts (ASTContext &Ctx) LLVM_READONLY
 
ExprignoreParenBaseCasts () LLVM_READONLY
 Ignore parentheses and derived-to-base casts. More...
 
const ExprignoreParenBaseCasts () const LLVM_READONLY
 
bool isDefaultArgument () const
 Determine whether this expression is a default function argument. More...
 
bool isTemporaryObject (ASTContext &Ctx, const CXXRecordDecl *TempTy) const
 Determine whether the result of this expression is a temporary object of the given class type. More...
 
bool isImplicitCXXThis () const
 Whether this expression is an implicit reference to 'this' in C++. More...
 
const ExprIgnoreImpCasts () const LLVM_READONLY
 
const ExprIgnoreParens () const LLVM_READONLY
 
const ExprIgnoreParenCasts () const LLVM_READONLY
 
const ExprIgnoreCasts () const LLVM_READONLY
 Strip off casts, but keep parentheses. More...
 
const ExprIgnoreParenNoopCasts (ASTContext &Ctx) const LLVM_READONLY
 
const CXXRecordDeclgetBestDynamicClassType () const
 For an expression of class type or pointer to class type, return the most derived class decl the expression is known to refer to. More...
 
const ExprskipRValueSubobjectAdjustments (SmallVectorImpl< const Expr * > &CommaLHS, SmallVectorImpl< SubobjectAdjustment > &Adjustments) const
 

Static Public Member Functions

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

Friends

class ASTStmtReader
 
class ASTStmtWriter
 

Additional Inherited Members

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

Detailed Description

Describes an C or C++ initializer list.

InitListExpr describes an initializer list, which can be used to initialize objects of different types, including struct/class/union types, arrays, and vectors. For example:

struct foo x = { 1, { 2, 3 } };

Prior to semantic analysis, an initializer list will represent the initializer list as written by the user, but will have the placeholder type "void". This initializer list is called the syntactic form of the initializer, and may contain C99 designated initializers (represented as DesignatedInitExprs), initializations of subobject members without explicit braces, and so on. Clients interested in the original syntax of the initializer list should use the syntactic form of the initializer list.

After semantic analysis, the initializer list will represent the semantic form of the initializer, where the initializations of all subobjects are made explicit with nested InitListExpr nodes and C99 designators have been eliminated by placing the designated initializations into the subobject they initialize. Additionally, any "holes" in the initialization, where no initializer has been specified for a particular subobject, will be replaced with implicitly-generated ImplicitValueInitExpr expressions that value-initialize the subobjects. Note, however, that the initializer lists may still have fewer initializers than there are elements to initialize within the object.

After semantic analysis has completed, given an initializer list, method isSemanticForm() returns true if and only if this is the semantic form of the initializer list (note: the same AST node may at the same time be the syntactic form). Given the semantic form of the initializer list, one can retrieve the syntactic form of that initializer list (when different) using method getSyntacticForm(); the method returns null if applied to a initializer list which is already in syntactic form. Similarly, given the syntactic form (i.e., an initializer list such that isSemanticForm() returns false), one can retrieve the semantic form using method getSemanticForm(). Since many initializer lists have the same syntactic and semantic forms, getSyntacticForm() may return NULL, indicating that the current semantic initializer list also serves as its syntactic form.

Definition at line 3759 of file Expr.h.

Member Typedef Documentation

Definition at line 3924 of file Expr.h.

Definition at line 3926 of file Expr.h.

Definition at line 3923 of file Expr.h.

Definition at line 3925 of file Expr.h.

Constructor & Destructor Documentation

InitListExpr::InitListExpr ( const ASTContext C,
SourceLocation  lbraceloc,
ArrayRef< Expr * >  initExprs,
SourceLocation  rbraceloc 
)
clang::InitListExpr::InitListExpr ( EmptyShell  Empty)
inlineexplicit

Build an empty initializer list.

Definition at line 3786 of file Expr.h.

Member Function Documentation

iterator clang::InitListExpr::begin ( )
inline

Definition at line 3928 of file Expr.h.

References clang::ASTVector< T >::begin().

const_iterator clang::InitListExpr::begin ( ) const
inline

Definition at line 3929 of file Expr.h.

References clang::ASTVector< T >::begin().

child_range clang::InitListExpr::children ( )
inline

Definition at line 3917 of file Expr.h.

References clang::ASTVector< T >::empty(), and clang::ASTVector< T >::size().

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

Definition at line 3912 of file Expr.h.

iterator clang::InitListExpr::end ( )
inline

Definition at line 3930 of file Expr.h.

References clang::ASTVector< T >::end().

const_iterator clang::InitListExpr::end ( ) const
inline

Definition at line 3931 of file Expr.h.

References clang::ASTVector< T >::end().

Expr* clang::InitListExpr::getArrayFiller ( )
inline

If this initializer list initializes an array with more elements than there are initializers in the list, specifies an expression to be used for value initialization of the rest of the elements.

Definition at line 3840 of file Expr.h.

Referenced by getArrayFiller(), and hasArrayFiller().

const Expr* clang::InitListExpr::getArrayFiller ( ) const
inline

Definition at line 3843 of file Expr.h.

References getArrayFiller().

const Expr* clang::InitListExpr::getInit ( unsigned  Init) const
inline
Expr* clang::InitListExpr::getInit ( unsigned  Init)
inline

Definition at line 3799 of file Expr.h.

References getNumInits().

FieldDecl* clang::InitListExpr::getInitializedFieldInUnion ( )
inline

If this initializes a union, specifies which field in the union to initialize.

Typically, this field is the first named field within the union. However, a designated initializer can specify the initialization of a different field within the union.

Definition at line 3858 of file Expr.h.

Referenced by getInitializedFieldInUnion(), clang::Expr::isConstantInitializer(), and setInitializedFieldInUnion().

const FieldDecl* clang::InitListExpr::getInitializedFieldInUnion ( ) const
inline

Definition at line 3861 of file Expr.h.

References getInitializedFieldInUnion().

Expr** clang::InitListExpr::getInits ( )
inline

Retrieve the set of initializers.

Definition at line 3792 of file Expr.h.

References clang::ASTVector< T >::data().

Referenced by setArrayFiller(), and TryConstructorInitialization().

SourceLocation clang::InitListExpr::getLBraceLoc ( ) const
inline

Definition at line 3882 of file Expr.h.

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

SourceLocation InitListExpr::getLocEnd ( ) const
SourceLocation InitListExpr::getLocStart ( ) const
unsigned clang::InitListExpr::getNumInits ( ) const
inline
SourceLocation clang::InitListExpr::getRBraceLoc ( ) const
inline

Definition at line 3884 of file Expr.h.

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

InitListExpr* clang::InitListExpr::getSemanticForm ( ) const
inline

Definition at line 3888 of file Expr.h.

References isSemanticForm().

InitListExpr* clang::InitListExpr::getSyntacticForm ( ) const
inline

Definition at line 3891 of file Expr.h.

References isSemanticForm().

Referenced by getLocEnd(), and getLocStart().

bool clang::InitListExpr::hadArrayRangeDesignator ( ) const
inline

Definition at line 3902 of file Expr.h.

bool clang::InitListExpr::hasArrayFiller ( ) const
inline

Return true if this is an array initializer and its array "filler" has been set.

Definition at line 3850 of file Expr.h.

References getArrayFiller().

Referenced by setArrayFiller().

bool clang::InitListExpr::isExplicit ( )
inline

Definition at line 3874 of file Expr.h.

References clang::SourceLocation::isValid().

bool clang::InitListExpr::isSemanticForm ( ) const
inline

Definition at line 3887 of file Expr.h.

Referenced by getSemanticForm(), and getSyntacticForm().

bool InitListExpr::isStringLiteralInit ( ) const
reverse_iterator clang::InitListExpr::rbegin ( )
inline

Definition at line 3932 of file Expr.h.

References clang::ASTVector< T >::rbegin().

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

const_reverse_iterator clang::InitListExpr::rbegin ( ) const
inline

Definition at line 3933 of file Expr.h.

References clang::ASTVector< T >::rbegin().

reverse_iterator clang::InitListExpr::rend ( )
inline

Definition at line 3934 of file Expr.h.

References clang::ASTVector< T >::rend().

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

const_reverse_iterator clang::InitListExpr::rend ( ) const
inline

Definition at line 3935 of file Expr.h.

References clang::ASTVector< T >::rend().

void InitListExpr::reserveInits ( const ASTContext C,
unsigned  NumInits 
)

Reserve space for some number of initializers.

Definition at line 1904 of file Expr.cpp.

References clang::ASTVector< T >::reserve(), and clang::ASTVector< T >::size().

void InitListExpr::resizeInits ( const ASTContext Context,
unsigned  NumInits 
)

Specify the number of initializers.

If there are more than NumInits initializers, the remaining initializers will be destroyed. If there are fewer than NumInits initializers, NULL expressions will be added for the unknown initializers.

Definition at line 1909 of file Expr.cpp.

References clang::ASTVector< T >::resize().

void clang::InitListExpr::sawArrayRangeDesignator ( bool  ARD = true)
inline

Definition at line 3905 of file Expr.h.

Referenced by InitListExpr().

void InitListExpr::setArrayFiller ( Expr filler)

Definition at line 1925 of file Expr.cpp.

References getInits(), getNumInits(), hasArrayFiller(), and clang::inits().

void clang::InitListExpr::setInit ( unsigned  Init,
Expr expr 
)
inline
void clang::InitListExpr::setInitializedFieldInUnion ( FieldDecl FD)
inline

Definition at line 3864 of file Expr.h.

References getInitializedFieldInUnion().

Referenced by ConstructTransparentUnion().

void clang::InitListExpr::setLBraceLoc ( SourceLocation  Loc)
inline

Definition at line 3883 of file Expr.h.

void clang::InitListExpr::setRBraceLoc ( SourceLocation  Loc)
inline

Definition at line 3885 of file Expr.h.

void clang::InitListExpr::setSyntacticForm ( InitListExpr Init)
inline

Definition at line 3895 of file Expr.h.

Referenced by clang::InitializationSequence::Perform().

Expr * InitListExpr::updateInit ( const ASTContext C,
unsigned  Init,
Expr expr 
)

Updates the initializer at index Init with the new expression expr, and returns the old expression at that location.

When Init is out of range for this initializer list, the initializer list will be extended with NULL expressions to accommodate the new entry.

Definition at line 1913 of file Expr.cpp.

References clang::ASTVector< T >::end(), clang::ASTVector< T >::insert(), clang::Result, setInit(), and clang::ASTVector< T >::size().

Friends And Related Function Documentation

friend class ASTStmtReader
friend

Definition at line 3937 of file Expr.h.

friend class ASTStmtWriter
friend

Definition at line 3938 of file Expr.h.


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