clang  6.0.0svn
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 "clang/AST/Expr.h"

Inheritance diagram for clang::InitListExpr:
Inheritance graph
[legend]
Collaboration diagram for clang::InitListExpr:
Collaboration graph
[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_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  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

 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...
 
Expr *const * getInits () const
 Retrieve the set of initializers. More...
 
ArrayRef< Expr * > inits ()
 
ArrayRef< Expr * > inits () const
 
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 () const
 
bool isStringLiteralInit () const
 
bool isTransparent () const
 Is this a transparent initializer list (that is, an InitListExpr that is purely syntactic, and whose semantics are that of the sole contained initializer)? More...
 
bool isIdiomaticZeroInitializer (const LangOptions &LangOpts) const
 Is this the zero initializer {0} in a language which considers it idiomatic? More...
 
SourceLocation getLBraceLoc () const
 
void setLBraceLoc (SourceLocation Loc)
 
SourceLocation getRBraceLoc () const
 
void setRBraceLoc (SourceLocation Loc)
 
bool isSemanticForm () const
 
InitListExprgetSemanticForm () const
 
bool isSyntacticForm () 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 ()
 
const_child_range children () const
 
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
 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 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...
 
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 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 getLocStart () const LLVM_READONLY
 
SourceLocation getLocEnd () 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
 
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, 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 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

- Protected Types inherited from clang::Stmt
enum  { NumStmtBits = 8 }
 
enum  { NumExprBits = 17 }
 
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
 
   CompoundStmtBitfields   CompoundStmtBits
 
   IfStmtBitfields   IfStmtBits
 
   ExprBitfields   ExprBits
 
   CharacterLiteralBitfields   CharacterLiteralBits
 
   FloatingLiteralBitfields   FloatingLiteralBits
 
   UnaryExprOrTypeTraitExprBitfields   UnaryExprOrTypeTraitExprBits
 
   DeclRefExprBitfields   DeclRefExprBits
 
   CastExprBitfields   CastExprBits
 
   CallExprBitfields   CallExprBits
 
   ExprWithCleanupsBitfields   ExprWithCleanupsBits
 
   PseudoObjectExprBitfields   PseudoObjectExprBits
 
   ObjCIndirectCopyRestoreExprBitfields   ObjCIndirectCopyRestoreExprBits
 
   InitListExprBitfields   InitListExprBits
 
   TypeTraitExprBitfields   TypeTraitExprBits
 
   CoawaitExprBitfields   CoawaitBits
 
}; 
 

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 3873 of file Expr.h.

Member Typedef Documentation

◆ const_iterator

Definition at line 4070 of file Expr.h.

◆ const_reverse_iterator

Definition at line 4072 of file Expr.h.

◆ iterator

Definition at line 4069 of file Expr.h.

◆ reverse_iterator

Definition at line 4071 of file Expr.h.

Constructor & Destructor Documentation

◆ InitListExpr() [1/2]

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

Definition at line 1864 of file Expr.cpp.

References sawArrayRangeDesignator().

◆ InitListExpr() [2/2]

clang::InitListExpr::InitListExpr ( EmptyShell  Empty)
inlineexplicit

Build an empty initializer list.

Definition at line 3900 of file Expr.h.

Member Function Documentation

◆ begin() [1/2]

iterator clang::InitListExpr::begin ( )
inline

Definition at line 4074 of file Expr.h.

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

◆ begin() [2/2]

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

Definition at line 4075 of file Expr.h.

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

◆ children() [1/2]

child_range clang::InitListExpr::children ( )
inline

Definition at line 4056 of file Expr.h.

References clang::cast_away_const(), and clang::children().

◆ children() [2/2]

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

Definition at line 4062 of file Expr.h.

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

◆ classof()

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

Definition at line 4051 of file Expr.h.

References clang::Stmt::getStmtClass().

◆ end() [1/2]

iterator clang::InitListExpr::end ( )
inline

Definition at line 4076 of file Expr.h.

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

◆ end() [2/2]

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

Definition at line 4077 of file Expr.h.

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

◆ getArrayFiller() [1/2]

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 3967 of file Expr.h.

Referenced by EvaluateArray(), isTrivialFiller(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ getArrayFiller() [2/2]

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

Definition at line 3970 of file Expr.h.

◆ getInit() [1/2]

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

◆ getInit() [2/2]

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

Definition at line 3926 of file Expr.h.

◆ getInitializedFieldInUnion() [1/2]

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 3985 of file Expr.h.

Referenced by clang::Expr::isConstantInitializer(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ getInitializedFieldInUnion() [2/2]

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

Definition at line 3988 of file Expr.h.

◆ getInits() [1/2]

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

Retrieve the set of initializers.

Definition at line 3906 of file Expr.h.

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

Referenced by setArrayFiller(), and TryConstructorInitialization().

◆ getInits() [2/2]

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

Retrieve the set of initializers.

Definition at line 3909 of file Expr.h.

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

◆ getLBraceLoc()

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

Definition at line 4018 of file Expr.h.

Referenced by TryListInitialization(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ getLocEnd()

SourceLocation InitListExpr::getLocEnd ( ) const

◆ getLocStart()

SourceLocation InitListExpr::getLocStart ( ) const

◆ getNumInits()

unsigned clang::InitListExpr::getNumInits ( ) const
inline

◆ getRBraceLoc()

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

Definition at line 4020 of file Expr.h.

Referenced by TryListInitialization().

◆ getSemanticForm()

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

Definition at line 4024 of file Expr.h.

◆ getSyntacticForm()

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

◆ hadArrayRangeDesignator()

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

Definition at line 4041 of file Expr.h.

Referenced by getAsInt32(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ hasArrayFiller()

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

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

Definition at line 3977 of file Expr.h.

Referenced by EvaluateArray(), setArrayFiller(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ inits() [1/2]

ArrayRef<Expr *> clang::InitListExpr::inits ( )
inline

Definition at line 3913 of file Expr.h.

References clang::getInits().

Referenced by setArrayFiller(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ inits() [2/2]

ArrayRef<Expr *> clang::InitListExpr::inits ( ) const
inline

Definition at line 3917 of file Expr.h.

References clang::getInits().

◆ isExplicit()

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

Definition at line 4001 of file Expr.h.

References clang::SourceLocation::isValid().

◆ isIdiomaticZeroInitializer()

bool InitListExpr::isIdiomaticZeroInitializer ( const LangOptions LangOpts) const

Is this the zero initializer {0} in a language which considers it idiomatic?

Definition at line 1954 of file Expr.cpp.

References getInit(), getNumInits(), clang::APIntStorage::getValue(), and isSyntacticForm().

Referenced by isIdiomaticBraceElisionEntity(), and warnBracedScalarInit().

◆ isSemanticForm()

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

Definition at line 4023 of file Expr.h.

Referenced by isTransparent().

◆ isStringLiteralInit()

bool InitListExpr::isStringLiteralInit ( ) const

◆ isSyntacticForm()

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

Definition at line 4027 of file Expr.h.

Referenced by isIdiomaticZeroInitializer().

◆ isTransparent()

bool InitListExpr::isTransparent ( ) const

Is this a transparent initializer list (that is, an InitListExpr that is purely syntactic, and whose semantics are that of the sole contained initializer)?

Definition at line 1931 of file Expr.cpp.

References clang::QualType::getCanonicalType(), getInit(), getNumInits(), clang::Expr::getType(), clang::Expr::isGLValue(), isRecordType(), clang::Expr::isRValue(), and isSemanticForm().

◆ rbegin() [1/2]

reverse_iterator clang::InitListExpr::rbegin ( )
inline

Definition at line 4078 of file Expr.h.

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

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

◆ rbegin() [2/2]

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

Definition at line 4079 of file Expr.h.

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

◆ rend() [1/2]

reverse_iterator clang::InitListExpr::rend ( )
inline

Definition at line 4080 of file Expr.h.

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

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

◆ rend() [2/2]

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

Definition at line 4081 of file Expr.h.

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

◆ reserveInits()

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

Reserve space for some number of initializers.

Definition at line 1886 of file Expr.cpp.

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

◆ resizeInits()

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 1891 of file Expr.cpp.

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

Referenced by warnBracedScalarInit().

◆ sawArrayRangeDesignator()

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

Definition at line 4044 of file Expr.h.

Referenced by InitListExpr(), and clang::ASTNodeImporter::VisitInitListExpr().

◆ setArrayFiller()

void InitListExpr::setArrayFiller ( Expr filler)

Definition at line 1907 of file Expr.cpp.

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

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

◆ setInit()

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

◆ setInitializedFieldInUnion()

void clang::InitListExpr::setInitializedFieldInUnion ( FieldDecl FD)
inline

Definition at line 3991 of file Expr.h.

Referenced by clang::ASTNodeImporter::VisitInitListExpr(), and warnBracedScalarInit().

◆ setLBraceLoc()

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

Definition at line 4019 of file Expr.h.

◆ setRBraceLoc()

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

Definition at line 4021 of file Expr.h.

Referenced by isIdiomaticBraceElisionEntity().

◆ setSyntacticForm()

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

Definition at line 4034 of file Expr.h.

Referenced by clang::ASTNodeImporter::VisitInitListExpr(), and warnBracedScalarInit().

◆ updateInit()

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

◆ ASTStmtReader

friend class ASTStmtReader
friend

Definition at line 4083 of file Expr.h.

◆ ASTStmtWriter

friend class ASTStmtWriter
friend

Definition at line 4084 of file Expr.h.


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