clang: clang::BlockDecl Class Reference (original) (raw)
Represents a block literal declaration, which is like an unnamed FunctionDecl. More...
Classes
class
A class which contains all the information about a particular captured value. More...
Public Types
using
param_iterator = MutableArrayRef< ParmVarDecl * >::iterator
using
param_const_iterator = ArrayRef< ParmVarDecl * >::const_iterator
using
capture_const_iterator = ArrayRef< Capture >::const_iterator
Public Types inherited from clang::Decl
enum
Lists the kind of concrete classes of Decl. More...
enum
IdentifierNamespace {
IDNS_Label = 0x0001 , IDNS_Tag = 0x0002 , IDNS_Type = 0x0004 , IDNS_Member = 0x0008 ,
IDNS_Namespace = 0x0010 , IDNS_Ordinary = 0x0020 , IDNS_ObjCProtocol = 0x0040 , IDNS_OrdinaryFriend = 0x0080 ,
IDNS_TagFriend = 0x0100 , IDNS_Using = 0x0200 , IDNS_NonMemberOperator = 0x0400 , IDNS_LocalExtern = 0x0800 ,
IDNS_OMPReduction = 0x1000 , IDNS_OMPMapper = 0x2000
}
IdentifierNamespace - The different namespaces in which declarations may appear. More...
enum
ObjCDeclQualifier {
OBJC_TQ_None = 0x0 , OBJC_TQ_In = 0x1 , OBJC_TQ_Inout = 0x2 , OBJC_TQ_Out = 0x4 ,
OBJC_TQ_Bycopy = 0x8 , OBJC_TQ_Byref = 0x10 , OBJC_TQ_Oneway = 0x20 , OBJC_TQ_CSNullability = 0x40
}
ObjCDeclQualifier - 'Qualifiers' written next to the return and parameter types in method declarations. More...
enum class
ModuleOwnershipKind : unsigned char {
Unowned, Visible, VisibleWhenImported, ReachableWhenImported,
ModulePrivate
}
The kind of ownership a declaration has, for visibility purposes. More...
enum
FriendObjectKind { FOK_None, FOK_Declared, FOK_Undeclared }
using
attr_iterator = AttrVec::const_iterator
using
attr_range = llvm::iterator_range< attr_iterator >
using
redecl_range = llvm::iterator_range< redecl_iterator >
Public Types inherited from clang::DeclContext
using
decl_range = llvm::iterator_range< decl_iterator >
using
lookup_result = DeclContextLookupResult
using
lookup_iterator = lookup_result::iterator
using
lookups_range = llvm::iterator_range< all_lookups_iterator >
using
udir_iterator_base = llvm::iterator_adaptor_base< udir_iterator, lookup_iterator, typename lookup_iterator::iterator_category, UsingDirectiveDecl * >
using
udir_range = llvm::iterator_range< udir_iterator >
using
ddiag_range = llvm::iterator_range< DeclContext::ddiag_iterator >
Public Member Functions
getCaretLocation () const
isVariadic () const
void
setIsVariadic (bool value)
getCompoundBody () const
Stmt *
getBody () const override
getBody - If this Decl represents a declaration for a body of code, such as a function or method definition, this method returns the top-level Stmt* of that body.
void
setBody (CompoundStmt *B)
void
setSignatureAsWritten (TypeSourceInfo *Sig)
getSignatureAsWritten () const
ArrayRef< ParmVarDecl * >
parameters () const
MutableArrayRef< ParmVarDecl * >
parameters ()
param_empty () const
param_begin ()
param_end ()
param_begin () const
param_end () const
param_size () const
getNumParams () const
const ParmVarDecl *
getParamDecl (unsigned i) const
getParamDecl (unsigned i)
void
setParams (ArrayRef< ParmVarDecl * > NewParamInfo)
hasCaptures () const
True if this block (or its nested blocks) captures anything of local storage from its enclosing scopes.
getNumCaptures () const
Returns the number of captured variables.
captures () const
capture_begin () const
capture_end () const
capturesCXXThis () const
void
setCapturesCXXThis (bool B=true)
blockMissingReturnType () const
void
setBlockMissingReturnType (bool val=true)
isConversionFromLambda () const
void
setIsConversionFromLambda (bool val=true)
doesNotEscape () const
void
setDoesNotEscape (bool B=true)
canAvoidCopyToHeap () const
void
setCanAvoidCopyToHeap (bool B=true)
capturesVariable (const VarDecl *var) const
void
setCaptures (ASTContext &Context, ArrayRef< Capture > Captures, bool CapturesCXXThis)
getBlockManglingNumber () const
Decl *
getBlockManglingContextDecl () const
void
setBlockMangling (unsigned Number, Decl *Ctx)
getSourceRange () const override LLVM_READONLY
Source range that this declaration covers.
getFunctionEffects () const
Public Member Functions inherited from clang::Decl
Decl ()=delete
Decl &
operator= (const Decl &)=delete
Decl &
virtual SourceRange
getSourceRange () const LLVM_READONLY
Source range that this declaration covers.
getBeginLoc () const LLVM_READONLY
getEndLoc () const LLVM_READONLY
getLocation () const
void
setLocation (SourceLocation L)
getKind () const
const char *
getDeclKindName () const
Decl *
const Decl *
getNextDeclInContext () const
const DeclContext *
getDeclContext () const
getNonTransparentDeclContext ()
Return the non transparent context.
const DeclContext *
getNonTransparentDeclContext () const
Decl *
Find the innermost non-closure ancestor of this declaration, walking up through blocks, lambdas, etc.
const Decl *
getNonClosureContext () const
const TranslationUnitDecl *
getTranslationUnitDecl () const
isInAnonymousNamespace () const
isInStdNamespace () const
isFileContextDecl () const
getASTContext () const LLVM_READONLY
const LangOptions &
getLangOpts () const LLVM_READONLY
Helper to get the language options from the ASTContext.
void
setAccess (AccessSpecifier AS)
getAccess () const
getAccessUnsafe () const
Retrieve the access specifier for this declaration, even though it may not yet have been properly set.
hasAttrs () const
void
setAttrs (const AttrVec &Attrs)
AttrVec &
getAttrs ()
const AttrVec &
getAttrs () const
void
dropAttrs ()
void
attrs () const
attr_begin () const
attr_end () const
template<typename... Ts>
void
dropAttrs ()
template<typename T >
void
dropAttr ()
template<typename T >
llvm::iterator_range< specific_attr_iterator< T > >
specific_attrs () const
template<typename T >
specific_attr_begin () const
template<typename T >
specific_attr_end () const
template<typename T >
T *
getAttr () const
template<typename T >
hasAttr () const
getMaxAlignment () const
getMaxAlignment - return the maximum alignment specified by attributes on this decl, 0 if there are none.
void
setInvalidDecl (bool Invalid=true)
setInvalidDecl - Indicates the Decl had a semantic error.
isInvalidDecl () const
isImplicit () const
isImplicit - Indicates whether the declaration was implicitly generated by the implementation.
void
setImplicit (bool I=true)
isUsed (bool CheckUsedAttr=true) const
Whether any (re-)declaration of the entity was used, meaning that a definition is required.
void
setIsUsed ()
Set whether the declaration is used, in the sense of odr-use.
void
markUsed (ASTContext &C)
Mark the declaration used, in the sense of odr-use.
isReferenced () const
Whether any declaration of this entity was referenced.
isThisDeclarationReferenced () const
Whether this declaration was referenced.
void
setReferenced (bool R=true)
isTopLevelDeclInObjCContainer () const
Whether this declaration is a top-level declaration (function, global variable, etc.) that is lexically inside an objc container definition.
void
setTopLevelDeclInObjCContainer (bool V=true)
ExternalSourceSymbolAttr *
getExternalSourceSymbolAttr () const
Looks on this and related declarations for an applicable external source symbol attribute.
isModulePrivate () const
Whether this declaration was marked as being private to the module in which it was defined.
isInExportDeclContext () const
Whether this declaration was exported in a lexical context.
isInvisibleOutsideTheOwningModule () const
isInAnotherModuleUnit () const
Whether this declaration comes from another module unit.
isInCurrentModuleUnit () const
Whether this declaration comes from the same module unit being compiled.
shouldEmitInExternalSource () const
Whether the definition of the declaration should be emitted in external sources.
isFromExplicitGlobalModule () const
Whether this declaration comes from explicit global module.
isFromGlobalModule () const
Whether this declaration comes from global module.
isInNamedModule () const
Whether this declaration comes from a named module.
isFromHeaderUnit () const
Whether this declaration comes from a header unit.
hasDefiningAttr () const
Return true if this declaration has an attribute which acts as definition of the entity, such as 'alias' or 'ifunc'.
const Attr *
getDefiningAttr () const
Return this declaration's defining attribute if it has one.
void
Set the FromASTFile flag.
void
setOwningModuleID (unsigned ID)
Set the owning module ID.
getAvailability (std::string *Message=nullptr, VersionTuple EnclosingVersion=VersionTuple(), StringRef *RealizedPlatform=nullptr) const
Determine the availability of the given declaration.
VersionTuple
getVersionIntroduced () const
Retrieve the version of the target platform in which this declaration was introduced.
isDeprecated (std::string *Message=nullptr) const
Determine whether this declaration is marked 'deprecated'.
isUnavailable (std::string *Message=nullptr) const
Determine whether this declaration is marked 'unavailable'.
isWeakImported () const
Determine whether this is a weak-imported symbol.
canBeWeakImported (bool &IsDefinition) const
Determines whether this symbol can be weak-imported, e.g., whether it would be well-formed to add the weak_import attribute.
isFromASTFile () const
Determine whether this declaration came from an AST file (such as a precompiled header or module) rather than having been parsed.
getGlobalID () const
Retrieve the global declaration ID associated with this declaration, which specifies where this Decl was loaded from.
getOwningModuleID () const
Retrieve the global ID of the module that owns this particular declaration.
Module *
getImportedOwningModule () const
Get the imported owning module, if this decl is from an imported (non-local) module.
Module *
getLocalOwningModule () const
Get the local owning module, if known.
void
setLocalOwningModule (Module *M)
hasOwningModule () const
Is this declaration owned by some module?
Module *
getOwningModule () const
Get the module that owns this declaration (for visibility purposes).
Module *
getTopLevelOwningNamedModule () const
Get the top level owning named module that owns this declaration if any.
Module *
getOwningModuleForLinkage () const
Get the module that owns this declaration for linkage purposes.
isUnconditionallyVisible () const
Determine whether this declaration is definitely visible to name lookup, independent of whether the owning module is visible.
isReachable () const
void
setVisibleDespiteOwningModule ()
Set that this declaration is globally visible, even if it came from a module that is not visible.
getModuleOwnershipKind () const
Get the kind of module ownership for this declaration.
void
setModuleOwnershipKind (ModuleOwnershipKind MOK)
Set whether this declaration is hidden from name lookup.
getIdentifierNamespace () const
isInIdentifierNamespace (unsigned NS) const
hasTagIdentifierNamespace () const
getLexicalDeclContext - The declaration context where this Decl was lexically declared (LexicalDC).
const DeclContext *
getLexicalDeclContext () const
virtual bool
isOutOfLine () const
Determine whether this declaration is declared out of line (outside its semantic context).
void
setDeclContext (DeclContext *DC)
setDeclContext - Set both the semantic and lexical DeclContext to DC.
void
setLexicalDeclContext (DeclContext *DC)
isTemplated () const
Determine whether this declaration is a templated entity (whether it is.
getTemplateDepth () const
Determine the number of levels of template parameter surrounding this declaration.
isDefinedOutsideFunctionOrMethod () const
isDefinedOutsideFunctionOrMethod - This predicate returns true if this scoped decl is defined outside the current function or method.
isInLocalScopeForInstantiation () const
Determine whether a substitution into this declaration would occur as part of a substitution into a dependent local scope.
const DeclContext *
getParentFunctionOrMethod (bool LexicalParent=false) const
If this decl is defined inside a function/method/block it returns the corresponding DeclContext, otherwise it returns null.
getParentFunctionOrMethod (bool LexicalParent=false)
virtual Decl *
Retrieves the "canonical" declaration of the given declaration.
const Decl *
getCanonicalDecl () const
isCanonicalDecl () const
Whether this particular Decl is a canonical one.
redecls () const
Returns an iterator range for all the redeclarations of the same decl.
redecls_begin () const
redecls_end () const
Decl *
Retrieve the previous declaration that declares the same entity as this declaration, or NULL if there is no previous declaration.
const Decl *
getPreviousDecl () const
Retrieve the previous declaration that declares the same entity as this declaration, or NULL if there is no previous declaration.
isFirstDecl () const
True if this is the first declaration in its redeclaration chain.
Decl *
Retrieve the most recent declaration that declares the same entity as this declaration (which may be this declaration).
const Decl *
getMostRecentDecl () const
Retrieve the most recent declaration that declares the same entity as this declaration (which may be this declaration).
virtual Stmt *
getBody () const
getBody - If this Decl represents a declaration for a body of code, such as a function or method definition, this method returns the top-level Stmt* of that body.
virtual bool
hasBody () const
Returns true if this [Decl](classclang%5F1%5F1Decl.html "Decl - This represents one declaration (or definition), e.g.")
represents a declaration for a body of code, such as a function or method definition.
getBodyRBrace () const
getBodyRBrace - Gets the right brace of the body, if a body exists.
isTemplateParameter () const
isTemplateParameter - Determines whether this declaration is a template parameter.
isTemplateParameterPack () const
isTemplateParameter - Determines whether this declaration is a template parameter pack.
isParameterPack () const
Whether this declaration is a parameter pack.
isTemplateDecl () const
returns true if this declaration is a template
isFunctionOrFunctionTemplate () const
Whether this declaration is a function or function template.
getDescribedTemplate () const
If this is a declaration that describes some template, this method returns that template declaration.
const TemplateParameterList *
getDescribedTemplateParams () const
If this is a declaration that describes some template or partial specialization, this returns the corresponding template parameter list.
getAsFunction () LLVM_READONLY
Returns the function itself, or the templated function if this is a function template.
const FunctionDecl *
getAsFunction () const
void
Changes the namespace of this declaration to reflect that it's a function-local extern declaration.
isLocalExternDecl () const
Determine whether this is a block-scope declaration with linkage.
void
setObjectOfFriendDecl (bool PerformFriendInjection=false)
Changes the namespace of this declaration to reflect that it's the object of a friend declaration.
void
Clears the namespace of this declaration.
getFriendObjectKind () const
Determines whether this declaration is the object of a friend declaration and, if so, what kind.
void
Specifies that this declaration is a C++ overloaded non-member.
void
print (raw_ostream &Out, unsigned Indentation=0, bool PrintInstantiation=false) const
void
print (raw_ostream &Out, const PrintingPolicy &Policy, unsigned Indentation=0, bool PrintInstantiation=false) const
void
dump () const
void
dumpColor () const
void
dump (raw_ostream &Out, bool Deserialize=false, ASTDumpOutputFormat OutputFormat=ADOF_Default) const
int64_t
getID () const
const FunctionType *
getFunctionType (bool BlocksToo=true) const
Looks through the Decl's underlying type to extract a FunctionType when possible.
isFunctionPointerType () const
Public Member Functions inherited from clang::DeclContext
~DeclContext ()
hasValidDeclKind () const
getDeclKind () const
const char *
getDeclKindName () const
getParent ()
getParent - Returns the containing DeclContext.
const DeclContext *
getParent () const
getLexicalParent - Returns the containing lexical DeclContext.
const DeclContext *
getLexicalParent () const
Find the parent context of this context that will be used for unqualified name lookup.
const DeclContext *
getLookupParent () const
getParentASTContext () const
isClosure () const
const BlockDecl *
getInnermostBlockDecl () const
Return this DeclContext if it is a BlockDecl.
isObjCContainer () const
isFunctionOrMethod () const
isLookupContext () const
Test whether the context supports looking up names.
isFileContext () const
isTranslationUnit () const
isRecord () const
isRequiresExprBody () const
isNamespace () const
isStdNamespace () const
isInlineNamespace () const
isDependentContext () const
Determines whether this context is dependent on a template parameter.
isTransparentContext () const
isTransparentContext - Determines whether this context is a "transparent" context, meaning that the members declared in this context are semantically declared in the nearest enclosing non-transparent (opaque) context but are lexically declared in this context.
isExternCContext () const
Determines whether this context or some of its ancestors is a linkage specification context that specifies C linkage.
const LinkageSpecDecl *
getExternCContext () const
Retrieve the nearest enclosing C linkage specification context.
isExternCXXContext () const
Determines whether this context or some of its ancestors is a linkage specification context that specifies C++ linkage.
Equals (const DeclContext *DC) const
Determine whether this declaration context is equivalent to the declaration context DC.
Encloses (const DeclContext *DC) const
Determine whether this declaration context encloses the declaration context DC.
Decl *
Find the nearest non-closure ancestor of this context, i.e.
const Decl *
getNonClosureAncestor () const
const DeclContext *
getNonTransparentContext () const
getPrimaryContext - There may be many different declarations of the same entity (including forward declarations of classes, multiple definitions of namespaces, etc.), each with a different set of declarations.
const DeclContext *
getPrimaryContext () const
getRedeclContext - Retrieve the context in which an entity conflicts with other entities of the same name, or where it is a redeclaration if the two entities are compatible.
const DeclContext *
getRedeclContext () const
getEnclosingNamespaceContext ()
Retrieve the nearest enclosing namespace context.
const DeclContext *
getEnclosingNamespaceContext () const
getOuterLexicalRecordContext ()
Retrieve the outermost lexically enclosing record context.
const RecordDecl *
getOuterLexicalRecordContext () const
InEnclosingNamespaceSetOf (const DeclContext *NS) const
Test if this context is part of the enclosing namespace set of the context NS, as defined in C++0x [namespace.def]p9.
void
collectAllContexts (SmallVectorImpl< DeclContext * > &Contexts)
Collects all of the declaration contexts that are semantically connected to this declaration context.
decls () const
decls_begin/decls_end - Iterate over the declarations stored in this context.
decls_begin () const
decls_end () const
decls_empty () const
noload_decls () const
noload_decls_begin/end - Iterate over the declarations stored in this context that are currently loaded; don't attempt to retrieve anything from an external source.
noload_decls_begin () const
noload_decls_end () const
void
Add the declaration D into this context.
void
addDeclInternal (Decl *D)
Add the declaration D into this context, but suppress searches for external declarations with the same name.
void
addHiddenDecl (Decl *D)
Add the declaration D to this context without modifying any lookup tables.
void
removeDecl (Decl *D)
Removes a declaration from this context.
containsDecl (Decl *D) const
Checks whether a declaration is in this context.
containsDeclAndLoad (Decl *D) const
Checks whether a declaration is in this context.
lookup (DeclarationName Name) const
lookup - Find the declarations (if any) with the given Name in this context.
noload_lookup (DeclarationName Name)
Find the declarations with the given name that are visible within this context; don't attempt to retrieve anything from an external source.
void
localUncachedLookup (DeclarationName Name, SmallVectorImpl< NamedDecl * > &Results)
A simplistic name lookup mechanism that performs name lookup into this declaration context without consulting the external source.
void
makeDeclVisibleInContext (NamedDecl *D)
Makes a declaration visible within this context.
lookups () const
noload_lookups (bool PreserveInternalState) const
lookups_begin () const
Iterators over all possible lookups within this context.
lookups_end () const
noload_lookups_begin () const
Iterators over all possible lookups within this context that are currently loaded; don't attempt to retrieve anything from an external source.
noload_lookups_end () const
using_directives () const
Returns iterator range [First, Last) of UsingDirectiveDecls stored within this context.
ddiags () const
void
Mark that there are external lexical declarations that we need to include in our lookup table (and that are not available as external visible lookups).
getLookupPtr () const
Retrieve the internal representation of the lookup structure.
buildLookup ()
Ensure the lookup structure is fully-built and return it.
hasExternalLexicalStorage () const
Whether this DeclContext has external storage containing additional declarations that are lexically in this context.
void
setHasExternalLexicalStorage (bool ES=true) const
State whether this DeclContext has external storage for declarations lexically in this context.
hasExternalVisibleStorage () const
Whether this DeclContext has external storage containing additional declarations that are visible in this context.
void
setHasExternalVisibleStorage (bool ES=true) const
State whether this DeclContext has external storage for declarations visible in this context.
isDeclInLexicalTraversal (const Decl *D) const
Determine whether the given declaration is stored in the list of declarations lexically within this context.
void
setUseQualifiedLookup (bool use=true) const
shouldUseQualifiedLookup () const
void
dumpAsDecl () const
void
dumpAsDecl (const ASTContext *Ctx) const
void
dumpDeclContext () const
void
dumpLookups () const
void
dumpLookups (llvm::raw_ostream &OS, bool DumpDecls=false, bool Deserialize=false) const
Static Public Member Functions
static BlockDecl *
Create (ASTContext &C, DeclContext *DC, SourceLocation L)
static BlockDecl *
CreateDeserialized (ASTContext &C, GlobalDeclID ID)
static bool
static bool
classofKind (Kind K)
static DeclContext *
castToDeclContext (const BlockDecl *D)
static BlockDecl *
castFromDeclContext (const DeclContext *DC)
Static Public Member Functions inherited from clang::Decl
static bool
isFlexibleArrayMemberLike (ASTContext &Context, const Decl *D, QualType Ty, LangOptions::StrictFlexArraysLevelKind StrictFlexArraysLevel, bool IgnoreTemplateOrMacroSubstitution)
Whether it resembles a flexible array member.
static unsigned
getIdentifierNamespaceForKind (Kind DK)
static bool
isTagIdentifierNamespace (unsigned NS)
static void
static void
static void
PrintStats ()
static bool
classofKind (Kind K)
static DeclContext *
castToDeclContext (const Decl *)
static Decl *
castFromDeclContext (const DeclContext *)
static void
printGroup (Decl **Begin, unsigned NumDecls, raw_ostream &Out, const PrintingPolicy &Policy, unsigned Indentation=0)
Static Public Member Functions inherited from clang::DeclContext
static bool
static bool
classof (const DeclContext *D)
Protected Member Functions
BlockDecl (DeclContext *DC, SourceLocation CaretLoc)
Protected Member Functions inherited from clang::Decl
void *
operator new (std::size_t Size, const ASTContext &Ctx, GlobalDeclID ID, std::size_t Extra=0)
Allocate memory for a deserialized declaration.
void *
operator new (std::size_t Size, const ASTContext &Ctx, DeclContext *Parent, std::size_t Extra=0)
Allocate memory for a non-deserialized declaration.
Decl (Kind DK, DeclContext *DC, SourceLocation L)
Decl (Kind DK, EmptyShell Empty)
virtual
~Decl ()
void
updateOutOfDate (IdentifierInfo &II) const
Update a potentially out-of-date declaration.
getCachedLinkage () const
void
setCachedLinkage (Linkage L) const
hasCachedLinkage () const
void
Specify that this declaration was marked as being private to the module in which it was defined.
hasLocalOwningModuleStorage () const
virtual Decl *
Returns the next redeclaration or itself if this is the only decl.
virtual Decl *
Implementation of getPreviousDecl(), to be overridden by any subclass that has a redeclaration chain.
virtual Decl *
Implementation of getMostRecentDecl(), to be overridden by any subclass that has a redeclaration chain.
getASTMutationListener () const
Protected Member Functions inherited from clang::DeclContext
Represents a block literal declaration, which is like an unnamed FunctionDecl.
For example: ^{ statement-body } or ^(int arg1, float arg2){ statement-body }