clang 8.0.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 "clang/AST/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_ConstQualifiedField, MLV_ConstAddrSpace, MLV_ArrayType, MLV_NoSetterProperty, MLV_MemberFunction, MLV_SubObjCPropertySetting, MLV_InvalidMessageExpression, MLV_ClassTemporary, MLV_ArrayTemporary }
enum | SideEffectsKind { SE_NoSideEffects, SE_AllowUndefinedBehavior, SE_AllowSideEffects }
enum | ConstExprUsage { EvaluateForCodeGen, EvaluateForMangling }
| Indicates how the constant expression will be used. More...
enum | NullPointerConstantKind { NPCK_NotNull = 0, NPCK_ZeroExpression, NPCK_ZeroLiteral, NPCK_CXX11_nullptr, NPCK_GNUNull }
| Enumeration used to describe the kind of Null pointer constant returned from `isNullPointerConstant()`. More...
enum | NullPointerConstantValueDependence { NPC_NeverValueDependent = 0, NPC_ValueDependentIsNull, NPC_ValueDependentIsNotNull }
| Enumeration used to describe how `isNullPointerConstant()` should cope with value-dependent expressions. More...
Public Types inherited from clang::Stmt
enum | StmtClass { NoStmtClass = 0 }
using | child_iterator = StmtIterator
| Child Iterators: All subclasses must implement 'children' to permit easy iteration over the substatements/subexpessions of an AST node. More...
using | const_child_iterator = ConstStmtIterator
using | child_range = llvm::iterator_range< child_iterator >
using | const_child_range = llvm::iterator_range< const_child_iterator >

## Public Member Functions
| 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 Expr * | getInit (unsigned Init) const
Expr * | getInit (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...
Expr * | 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. More...
Expr * | getArrayFiller ()
| 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 Expr * | getArrayFiller () const
void | setArrayFiller (Expr *filler)
bool | hasArrayFiller () const
| Return true if this is an array initializer and its array "filler" has been set. More...
FieldDecl * | getInitializedFieldInUnion ()
| If this initializes a union, specifies which field in the union to initialize. More...
const FieldDecl * | getInitializedFieldInUnion () 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
InitListExpr * | getSemanticForm () const
bool | isSyntacticForm () const
InitListExpr * | getSyntacticForm () const
void | setSyntacticForm (InitListExpr *Init)
bool | hadArrayRangeDesignator () const
void | sawArrayRangeDesignator (bool ARD=true)
SourceLocation | getBeginLoc () const LLVM_READONLY
SourceLocation | getEndLoc () 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...
FieldDecl * | getSourceBitField ()
| If this expression refers to a bit-field, retrieve the declaration of that bit-field. More...
const FieldDecl * | getSourceBitField () const
Decl * | getReferencedDeclOfCallee ()
const Decl * | getReferencedDeclOfCallee () const
const ObjCPropertyRefExpr * | getObjCProperty () const
| If this expression is an l-value for an Objective C property, find the underlying property reference expression. More...
bool | isObjCSelfExpr () const
| Check if this expression is the ObjC 'self' implicit parameter. More...
bool | refersToVectorElement () const
| Returns whether this expression refers to a vector element. More...
bool | refersToGlobalRegisterVar () const
| Returns whether this expression refers to a global register variable. More...
bool | hasPlaceholderType () const
| Returns whether this expression has a placeholder type. More...
bool | hasPlaceholderType (BuiltinType::Kind K) const
| Returns whether this expression has a specific placeholder type. More...
bool | isKnownToHaveBooleanValue () const
| isKnownToHaveBooleanValue - Return true if this is an integer expression that is known to return 0 or 1. More...
bool | isIntegerConstantExpr (llvm::APSInt &Result, const ASTContext &Ctx, SourceLocation *Loc=nullptr, bool isEvaluated=true) const
| isIntegerConstantExpr - Return true if this expression is a valid integer constant expression, and, if so, return its value in Result. More...
bool | isIntegerConstantExpr (const ASTContext &Ctx, SourceLocation *Loc=nullptr) const
bool | isCXX98IntegralConstantExpr (const ASTContext &Ctx) const
| isCXX98IntegralConstantExpr - Return true if this expression is an integral constant expression in C++98. More...
bool | isCXX11ConstantExpr (const ASTContext &Ctx, APValue *Result=nullptr, SourceLocation *Loc=nullptr) const
| isCXX11ConstantExpr - Return true if this expression is a constant expression in C++11. More...
bool | isConstantInitializer (ASTContext &Ctx, bool ForRef, const Expr **Culprit=nullptr) const
| isConstantInitializer - Returns true if this expression can be emitted to IR as a constant, and thus can be used as a constant initializer in C. More...
bool | EvaluateAsRValue (EvalResult &Result, const ASTContext &Ctx, bool InConstantContext=false) const
| EvaluateAsRValue - Return true if this is a constant which we can fold to an rvalue using any crazy technique (that has nothing to do with language standards) that we want to, even if the expression has side-effects. More...
bool | EvaluateAsBooleanCondition (bool &Result, const ASTContext &Ctx) const
| EvaluateAsBooleanCondition - Return true if this is a constant which we can fold and convert to a boolean condition using any crazy technique that we want to, even if the expression has side-effects. More...
bool | EvaluateAsInt (EvalResult &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
| EvaluateAsInt - Return true if this is a constant which we can fold and convert to an integer, using any crazy technique that we want to. More...
bool | EvaluateAsFloat (llvm::APFloat &Result, const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
| EvaluateAsFloat - Return true if this is a constant which we can fold and convert to a floating point value, using any crazy technique that we want to. More...
bool | isEvaluatable (const ASTContext &Ctx, SideEffectsKind AllowSideEffects=SE_NoSideEffects) const
| isEvaluatable - Call EvaluateAsRValue to see if this expression can be constant folded without side-effects, but discard the result. More...
bool | HasSideEffects (const ASTContext &Ctx, bool IncludePossibleEffects=true) const
| HasSideEffects - This routine returns true for all those expressions which have any effect other than producing a value. More...
bool | hasNonTrivialCall (const ASTContext &Ctx) const
| Determine whether this expression involves a call to any function that is not trivial. More...
llvm::APSInt | EvaluateKnownConstInt (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const
| EvaluateKnownConstInt - Call EvaluateAsRValue and return the folded integer. More...
llvm::APSInt | EvaluateKnownConstIntCheckOverflow (const ASTContext &Ctx, SmallVectorImpl< PartialDiagnosticAt > *Diag=nullptr) const
void | EvaluateForOverflow (const ASTContext &Ctx) const
bool | EvaluateAsLValue (EvalResult &Result, const ASTContext &Ctx) const
| EvaluateAsLValue - Evaluate an expression to see if we can fold it to an lvalue with link time known address, with no side-effects. More...
bool | EvaluateAsInitializer (APValue &Result, const ASTContext &Ctx, const VarDecl *VD, SmallVectorImpl< PartialDiagnosticAt > &Notes) const
| EvaluateAsInitializer - Evaluate an expression as if it were the initializer of the given declaration. More...
bool | EvaluateWithSubstitution (APValue &Value, ASTContext &Ctx, const FunctionDecl *Callee, ArrayRef< const Expr *> Args, const Expr *This=nullptr) const
| EvaluateWithSubstitution - Evaluate an expression as if from the context of a call to the given function with the given arguments, inside an unevaluated context. More...
bool | EvaluateAsConstantExpr (EvalResult &Result, ConstExprUsage Usage, const ASTContext &Ctx) const
| Evaluate an expression that is required to be a constant expression. More...
bool | tryEvaluateObjectSize (uint64_t &Result, ASTContext &Ctx, unsigned Type) const
| If the current Expr is a pointer, this will try to statically determine the number of bytes available where the pointer is pointing. More...
NullPointerConstantKind | isNullPointerConstant (ASTContext &Ctx, NullPointerConstantValueDependence NPC) const
| isNullPointerConstant - C99 6.3.2.3p3 - Test if this reduces down to a Null pointer constant. More...
bool | isOBJCGCCandidate (ASTContext &Ctx) const
| isOBJCGCCandidate - Return true if this expression may be used in a read/ write barrier. More...
bool | isBoundMemberFunction (ASTContext &Ctx) const
| Returns true if this expression is a bound member function. More...
Expr * | IgnoreImpCasts () LLVM_READONLY
| IgnoreImpCasts - Skip past any implicit casts which might surround this expression. More...
Expr * | IgnoreImplicit () LLVM_READONLY
| IgnoreImplicit - Skip past any implicit AST nodes which might surround this expression. More...
const Expr * | IgnoreImplicit () const LLVM_READONLY
Expr * | IgnoreParens () LLVM_READONLY
| IgnoreParens - Ignore parentheses. More...
Expr * | IgnoreParenCasts () LLVM_READONLY
| IgnoreParenCasts - Ignore parentheses and casts. More...
Expr * | IgnoreCasts () LLVM_READONLY
| Ignore casts. Strip off any CastExprs, returning their operand. More...
Expr * | IgnoreParenImpCasts () LLVM_READONLY
| IgnoreParenImpCasts - Ignore parentheses and implicit casts. More...
Expr * | IgnoreConversionOperator () LLVM_READONLY
| IgnoreConversionOperator - Ignore conversion operator. More...
const Expr * | IgnoreConversionOperator () const LLVM_READONLY
const Expr * | IgnoreParenImpCasts () const LLVM_READONLY
Expr * | IgnoreParenLValueCasts () LLVM_READONLY
| Ignore parentheses and lvalue casts. More...
const Expr * | IgnoreParenLValueCasts () const LLVM_READONLY
Expr * | IgnoreParenNoopCasts (ASTContext &Ctx) LLVM_READONLY
| IgnoreParenNoopCasts - Ignore parentheses and casts that do not change the value (including ptr->int casts of the same size). More...
Expr * | ignoreParenBaseCasts () LLVM_READONLY
| Ignore parentheses and derived-to-base casts. More...
const Expr * | ignoreParenBaseCasts () const LLVM_READONLY
bool | isDefaultArgument () const
| Determine whether this expression is a default function argument. More...
bool | isTemporaryObject (ASTContext &Ctx, const CXXRecordDecl *TempTy) const
| Determine whether the result of this expression is a temporary object of the given class type. More...
bool | isImplicitCXXThis () const
| Whether this expression is an implicit reference to 'this' in C++. More...
const Expr * | IgnoreImpCasts () const LLVM_READONLY
const Expr * | IgnoreParens () const LLVM_READONLY
const Expr * | IgnoreParenCasts () const LLVM_READONLY
const Expr * | IgnoreCasts () const LLVM_READONLY
| Strip off casts, but keep parentheses. More...
const Expr * | IgnoreParenNoopCasts (ASTContext &Ctx) const LLVM_READONLY
const CXXRecordDecl * | getBestDynamicClassType () const
| For an expression of class type or pointer to class type, return the most derived class decl the expression is known to refer to. More...
const Expr * | getBestDynamicClassTypeExpr () const
| Get the inner expression that determines the best dynamic class. More...
const Expr * | skipRValueSubobjectAdjustments (SmallVectorImpl< const Expr *> &CommaLHS, SmallVectorImpl< SubobjectAdjustment > &Adjustments) const
| Walk outwards from an expression we want to bind a reference to and find the expression whose lifetime needs to be extended. More...
const Expr * | skipRValueSubobjectAdjustments () const
Public Member Functions inherited from clang::Stmt
void * | operator new (size_t bytes, const ASTContext &C, unsigned alignment=8)
void * | operator new (size_t bytes, const ASTContext *C, unsigned alignment=8)
void * | operator new (size_t bytes, void *mem) noexcept
void | operator delete (void *, const ASTContext &, unsigned) noexcept
void | operator delete (void *, const ASTContext *, unsigned) noexcept
void | operator delete (void *, size_t) noexcept
void | operator delete (void *, void *) noexcept
| Stmt (StmtClass SC)
StmtClass | getStmtClass () const
const char * | getStmtClassName () const
SourceRange | getSourceRange () const LLVM_READONLY
| SourceLocation tokens are not useful in isolation - they are low level value objects created/interpreted by SourceManager. More...
SourceLocation | getBeginLoc () const LLVM_READONLY
SourceLocation | getEndLoc () const LLVM_READONLY
void | dump () const
| Dumps the specified AST fragment and all subtrees to `llvm::errs()`. More...
void | dump (SourceManager &SM) const
void | dump (raw_ostream &OS, SourceManager &SM) const
void | dump (raw_ostream &OS) const
int64_t | getID (const ASTContext &Context) const
void | dumpColor () const
| dumpColor - same as dump(), but forces color highlighting. More...
void | dumpPretty (const ASTContext &Context) const
| dumpPretty/printPretty - These two methods do a "pretty print" of the AST back to its original source language syntax. More...
void | printPretty (raw_ostream &OS, PrinterHelper *Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\, const ASTContext *Context=nullptr) const
void | viewAST () const
| viewAST - Visualize an AST rooted at this Stmt* using GraphViz. More...
Stmt * | IgnoreImplicit ()
| Skip past any implicit AST nodes which might surround this statement, such as ExprWithCleanups or ImplicitCastExpr nodes. More...
const Stmt * | IgnoreImplicit () const
Stmt * | IgnoreContainers (bool IgnoreCaptured=false)
| Skip no-op (attributed, compound) container stmts and skip captured stmt at the top, if IgnoreCaptured is true. More...
const Stmt * | IgnoreContainers (bool IgnoreCaptured=false) const
const Stmt * | stripLabelLikeStatements () const
| Strip off all label-like statements. More...
Stmt * | stripLabelLikeStatements ()
child_range | children ()
const_child_range | children () const
child_iterator | child_begin ()
child_iterator | child_end ()
const_child_iterator | child_begin () const
const_child_iterator | child_end () const
void | Profile (llvm::FoldingSetNodeID &ID, const ASTContext &Context, bool Canonical) const
| Produce a unique representation of the given statement. More...
void | ProcessODRHash (llvm::FoldingSetNodeID &ID, ODRHash &Hash) const
| Calculate a unique representation for a statement that is stable across compiler invocations. More...

## Static Public Member Functions
static 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 = NumStmtBits + 9 }
enum | APFloatSemantics { IEEEhalf, IEEEsingle, IEEEdouble, x87DoubleExtended, IEEEquad, PPCDoubleDouble }
enum | { NumCallExprBits = 32 }
enum | { NumOverloadExprBits = NumExprBits + 1 }
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
ArraySubscriptExprBitfields ArraySubscriptExprBits
CallExprBitfields CallExprBits
MemberExprBitfields MemberExprBits
CastExprBitfields CastExprBits
BinaryOperatorBitfields BinaryOperatorBits
InitListExprBitfields InitListExprBits
ParenListExprBitfields ParenListExprBits
PseudoObjectExprBitfields PseudoObjectExprBits
CXXOperatorCallExprBitfields CXXOperatorCallExprBits
CXXBoolLiteralExprBitfields CXXBoolLiteralExprBits
CXXNullPtrLiteralExprBitfields CXXNullPtrLiteralExprBits
CXXThisExprBitfields CXXThisExprBits
CXXThrowExprBitfields CXXThrowExprBits
CXXDefaultArgExprBitfields CXXDefaultArgExprBits
CXXDefaultInitExprBitfields CXXDefaultInitExprBits
CXXScalarValueInitExprBitfields CXXScalarValueInitExprBits
CXXNewExprBitfields CXXNewExprBits
CXXDeleteExprBitfields CXXDeleteExprBits
TypeTraitExprBitfields TypeTraitExprBits
DependentScopeDeclRefExprBitfields DependentScopeDeclRefExprBits
CXXConstructExprBitfields CXXConstructExprBits
ExprWithCleanupsBitfields ExprWithCleanupsBits
CXXUnresolvedConstructExprBitfields CXXUnresolvedConstructExprBits
CXXDependentScopeMemberExprBitfields CXXDependentScopeMemberExprBits
OverloadExprBitfields OverloadExprBits
UnresolvedLookupExprBitfields UnresolvedLookupExprBits
UnresolvedMemberExprBitfields UnresolvedMemberExprBits
CXXNoexceptExprBitfields CXXNoexceptExprBits
SubstNonTypeTemplateParmExprBitfields SubstNonTypeTemplateParmExprBits
CoawaitExprBitfields CoawaitBits
ObjCIndirectCopyRestoreExprBitfields ObjCIndirectCopyRestoreExprBits
OpaqueValueExprBitfields OpaqueValueExprBits
}; |

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

## Member Typedef Documentation

## ◆ const_iterator

typedef InitExprsTy::const_iterator clang::InitListExpr::const_iterator

Definition at line 4382 of file Expr.h.

## ◆ const_reverse_iterator

typedef InitExprsTy::const_reverse_iterator clang::InitListExpr::const_reverse_iterator

Definition at line 4384 of file Expr.h.

## ◆ iterator

typedef InitExprsTy::iterator clang::InitListExpr::iterator

Definition at line 4381 of file Expr.h.

## ◆ reverse_iterator

typedef InitExprsTy::reverse_iterator clang::InitListExpr::reverse_iterator

Definition at line 4383 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 1992 of file Expr.cpp.

References clang::Expr::containsUnexpandedParameterPack(), clang::ASTVector< T >::end(), clang::Stmt::ExprBits, clang::if(), clang::ASTVector< T >::insert(), clang::Expr::isInstantiationDependent(), clang::Expr::isTypeDependent(), clang::Expr::isValueDependent(), and sawArrayRangeDesignator().

## ◆ InitListExpr() [2/2]

clang::InitListExpr::InitListExpr | ( | EmptyShell | Empty | ) |
| inline explicit

Build an empty initializer list.

Definition at line 4212 of file Expr.h.

## Member Function Documentation

## ◆ begin() [1/2]

iterator clang::InitListExpr::begin | ( |  | ) |
| inline

Definition at line 4386 of file Expr.h.

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

## ◆ begin() [2/2]

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

Definition at line 4387 of file Expr.h.

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

## ◆ children() [1/2]

child_range clang::InitListExpr::children | ( |  | ) |
| inline

Definition at line 4368 of file Expr.h.

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

Referenced by clang::if().

## ◆ children() [2/2]

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

Definition at line 4374 of file Expr.h.

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

## ◆ classof()

static bool clang::InitListExpr::classof | ( | const Stmt * | T | ) |
| inline static

Definition at line 4363 of file Expr.h.

References clang::Stmt::getStmtClass().

## ◆ end() [1/2]

iterator clang::InitListExpr::end | ( |  | ) |
| inline

Definition at line 4388 of file Expr.h.

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

## ◆ end() [2/2]

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

Definition at line 4389 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 4279 of file Expr.h.

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

## ◆ getArrayFiller() [2/2]

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

Definition at line 4282 of file Expr.h.

## ◆ getBeginLoc()

SourceLocation InitListExpr::getBeginLoc | ( |  | ) | const

Definition at line 2093 of file Expr.cpp.

References clang::ASTVector< T >::begin(), clang::ASTVector< T >::end(), getSyntacticForm(), and clang::SourceLocation::isInvalid().

Referenced by diagnoseListInit(), clang::Expr::isUnusedResultAWarning(), TryListConversion(), and TryListInitialization().

## ◆ getEndLoc()

SourceLocation InitListExpr::getEndLoc | ( |  | ) | const

Definition at line 2111 of file Expr.cpp.

References End, getSyntacticForm(), clang::SourceLocation::isInvalid(), clang::ASTVector< T >::rbegin(), and clang::ASTVector< T >::rend().

## ◆ getInit() [1/2]

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

Definition at line 4233 of file Expr.h.

Referenced by clang::Sema::DeduceTemplateSpecializationFromInitializer(), clang::CodeGen::CodeGenFunction::EmitInitListLValue(), EvaluateComplex(), EvaluateVector(), getAsInt32(), GetNumNonZeroBytesInInit(), HandleConstructorCall(), clang::Expr::isConstantInitializer(), isIdiomaticZeroInitializer(), isImplicitThis(), isParenthesizedADLCallee(), isSimpleZero(), isStringLiteralInit(), isTransparent(), isTrivialFiller(), MaybeElementDependentArrayFiller(), TryListConversion(), TryListInitialization(), TryReferenceListInitialization(), clang::ento::ExprEngine::VisitInitListExpr(), visitLocalsRetainedByInitializer(), and visitLocalsRetainedByReferenceBinding().

## ◆ getInit() [2/2]

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

Definition at line 4238 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 4297 of file Expr.h.

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

## ◆ getInitializedFieldInUnion() [2/2]

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

Definition at line 4300 of file Expr.h.

## ◆ getInits() [1/2]

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

Retrieve the set of initializers.

Definition at line 4218 of file Expr.h.

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

Referenced by clang::Sema::DeduceTemplateSpecializationFromInitializer(), setArrayFiller(), and TryConstructorInitialization().

## ◆ getInits() [2/2]

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

Retrieve the set of initializers.

Definition at line 4221 of file Expr.h.

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

## ◆ getLBraceLoc()

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

Definition at line 4330 of file Expr.h.

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

## ◆ getNumInits()

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

Definition at line 4215 of file Expr.h.

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

Referenced by DeduceFromInitializerList(), clang::Sema::DeduceTemplateSpecializationFromInitializer(), diagnoseListInit(), clang::CodeGen::CodeGenFunction::EmitCXXNewExpr(), EvaluateComplex(), EvaluateVector(), getAsInt32(), GetNumNonZeroBytesInInit(), HandleConstructorCall(), clang::Expr::isConstantInitializer(), isIdiomaticZeroInitializer(), isImplicitThis(), isParenthesizedADLCallee(), isSimpleZero(), isStringLiteralInit(), isTransparent(), isTrivialFiller(), MaybeElementDependentArrayFiller(), clang::InitializationSequence::RewrapReferenceInitList(), setArrayFiller(), TryConstructorInitialization(), TryListConversion(), TryListInitialization(), TryReferenceListInitialization(), TryValueInitialization(), clang::ento::ExprEngine::VisitInitListExpr(), clang::ASTNodeImporter::VisitInitListExpr(), and visitLocalsRetainedByInitializer().

## ◆ getRBraceLoc()

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

Definition at line 4332 of file Expr.h.

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

## ◆ getSemanticForm()

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

Definition at line 4336 of file Expr.h.

## ◆ getSyntacticForm()

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

Definition at line 4342 of file Expr.h.

Referenced by getBeginLoc(), getEndLoc(), clang::if(), isImplicitThis(), isParenthesizedADLCallee(), and clang::ASTNodeImporter::VisitInitListExpr().

## ◆ hadArrayRangeDesignator()

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

Definition at line 4353 of file Expr.h.

Referenced by getAsInt32(), isSimpleZero(), 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 4289 of file Expr.h.

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

## ◆ inits() [1/2]

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

Definition at line 4225 of file Expr.h.

References clang::getInits().

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

## ◆ inits() [2/2]

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

Definition at line 4229 of file Expr.h.

References clang::getInits().

## ◆ isExplicit()

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

Definition at line 4313 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 2082 of file Expr.cpp.

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

## ◆ isSemanticForm()

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

Definition at line 4335 of file Expr.h.

Referenced by clang::if(), and isTransparent().

## ◆ isStringLiteralInit()

bool InitListExpr::isStringLiteralInit | ( |  | ) | const

Definition at line 2045 of file Expr.cpp.

References clang::Type::getAsArrayTypeUnsafe(), clang::ArrayType::getElementType(), getInit(), getNumInits(), clang::Expr::getType(), clang::Expr::IgnoreParens(), and clang::Type::isIntegerType().

Referenced by clang::CodeGen::CodeGenFunction::EmitCXXNewExpr(), and MaybeElementDependentArrayFiller().

## ◆ isSyntacticForm()

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

Definition at line 4339 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 2059 of file Expr.cpp.

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

Referenced by clang::CodeGen::CodeGenFunction::EmitInitListLValue(), GetNumNonZeroBytesInInit(), isSimpleZero(), visitLocalsRetainedByInitializer(), and visitLocalsRetainedByReferenceBinding().

## ◆ rbegin() [1/2]

reverse_iterator clang::InitListExpr::rbegin | ( |  | ) |
| inline

Definition at line 4390 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 4391 of file Expr.h.

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

## ◆ rend() [1/2]

reverse_iterator clang::InitListExpr::rend | ( |  | ) |
| inline

Definition at line 4392 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 4393 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 2014 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 2019 of file Expr.cpp.

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

## ◆ sawArrayRangeDesignator()

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

Definition at line 4356 of file Expr.h.

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

## ◆ setArrayFiller()

void InitListExpr::setArrayFiller | ( | Expr * | filler | ) |

Definition at line 2035 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

Definition at line 4243 of file Expr.h.

References clang::Expr::containsUnexpandedParameterPack(), clang::ast_matchers::expr, clang::Expr::isInstantiationDependent(), clang::Expr::isTypeDependent(), and clang::Expr::isValueDependent().

Referenced by updateInit().

## ◆ setInitializedFieldInUnion()

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

Definition at line 4303 of file Expr.h.

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

## ◆ setLBraceLoc()

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

Definition at line 4331 of file Expr.h.

## ◆ setRBraceLoc()

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

Definition at line 4333 of file Expr.h.

## ◆ setSyntacticForm()

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

Definition at line 4346 of file Expr.h.

Referenced by clang::InitializationSequence::Perform(), 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 2023 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 4395 of file Expr.h.

## ◆ ASTStmtWriter

friend class ASTStmtWriter
| friend

Definition at line 4396 of file Expr.h.

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

- include/clang/AST/Expr.h
- lib/AST/Expr.cpp