This captures a statement into a function. More...

#include "clang/AST/Stmt.h"

Inheritance diagram for clang::CapturedStmt:

Classes
class	Capture
	Describes the capture of either a variable, or 'this', or variable-length array type. More...

Public Types
enum	VariableCaptureKind { VCK_This , VCK_ByRef , VCK_ByCopy , VCK_VLAType }
	The different capture forms: by 'this', by reference, capture for variable-length array type etc. More...

using	capture_iterator = Capture *
	An iterator that walks over the captures.

using	const_capture_iterator = const Capture *

using	capture_range = llvm::iterator_range< capture_iterator >

using	capture_const_range = llvm::iterator_range< const_capture_iterator >

using	capture_init_iterator = Expr **
	Iterator that walks over the capture initialization arguments.

using	capture_init_range = llvm::iterator_range< capture_init_iterator >

using	const_capture_init_iterator = Expr const
	Const iterator that walks over the capture initialization arguments.

using	const_capture_init_range = llvm::iterator_range< const_capture_init_iterator >

Public Types inherited from clang::Stmt
enum	StmtClass { NoStmtClass = 0 }

enum	Likelihood { LH_Unlikely = -1 , LH_None , LH_Likely }
	The likelihood of a branch being taken. More...

using	child_iterator = StmtIterator
	Child Iterators: All subclasses must implement 'children' to permit easy iteration over the substatements/subexpressions of an AST node.

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
Stmt *	getCapturedStmt ()
	Retrieve the statement being captured.

const Stmt *	getCapturedStmt () const

CapturedDecl *	getCapturedDecl ()
	Retrieve the outlined function declaration.

const CapturedDecl *	getCapturedDecl () const

void	setCapturedDecl (CapturedDecl *D)
	Set the outlined function declaration.

CapturedRegionKind	getCapturedRegionKind () const
	Retrieve the captured region kind.

void	setCapturedRegionKind (CapturedRegionKind Kind)
	Set the captured region kind.

const RecordDecl *	getCapturedRecordDecl () const
	Retrieve the record declaration for captured variables.

void	setCapturedRecordDecl (RecordDecl *D)
	Set the record declaration for captured variables.

bool	capturesVariable (const VarDecl *Var) const
	True if this variable has been captured.

capture_range	captures ()

capture_const_range	captures () const

capture_iterator	capture_begin ()
	Retrieve an iterator pointing to the first capture.

const_capture_iterator	capture_begin () const

capture_iterator	capture_end () const
	Retrieve an iterator pointing past the end of the sequence of captures.

unsigned	capture_size () const
	Retrieve the number of captures, including 'this'.

capture_init_range	capture_inits ()

const_capture_init_range	capture_inits () const

capture_init_iterator	capture_init_begin ()
	Retrieve the first initialization argument.

const_capture_init_iterator	capture_init_begin () const

capture_init_iterator	capture_init_end ()
	Retrieve the iterator pointing one past the last initialization argument.

const_capture_init_iterator	capture_init_end () const

SourceLocation	getBeginLoc () const LLVM_READONLY

SourceLocation	getEndLoc () const LLVM_READONLY

SourceRange	getSourceRange () const LLVM_READONLY

child_range	children ()

const_child_range	children () 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 ()=delete

	Stmt (const Stmt &)=delete

	Stmt (Stmt &&)=delete

Stmt &	operator= (const Stmt &)=delete

Stmt &	operator= (Stmt &&)=delete

	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.

SourceLocation	getBeginLoc () const LLVM_READONLY

SourceLocation	getEndLoc () const LLVM_READONLY

void	dump () const
	Dumps the specified AST fragment and all subtrees to `llvm::errs()`.

void	dump (raw_ostream &OS, const ASTContext &Context) const

int64_t	getID (const ASTContext &Context) const

void	dumpColor () const
	dumpColor - same as dump(), but forces color highlighting.

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.

void	printPretty (raw_ostream &OS, PrinterHelper Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\n", const ASTContext Context=nullptr) const

void	printPrettyControlled (raw_ostream &OS, PrinterHelper Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\n", const ASTContext Context=nullptr) const

void	printJson (raw_ostream &Out, PrinterHelper *Helper, const PrintingPolicy &Policy, bool AddQuotes) const
	Pretty-prints in JSON format.

void	viewAST () const
	viewAST - Visualize an AST rooted at this Stmt* using GraphViz.

Stmt *	IgnoreContainers (bool IgnoreCaptured=false)
	Skip no-op (attributed, compound) container stmts and skip captured stmt at the top, if IgnoreCaptured is true.

const Stmt *	IgnoreContainers (bool IgnoreCaptured=false) const

const Stmt *	stripLabelLikeStatements () const
	Strip off all label-like statements.

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, bool ProfileLambdaExpr=false) const
	Produce a unique representation of the given statement.

void	ProcessODRHash (llvm::FoldingSetNodeID &ID, ODRHash &Hash) const
	Calculate a unique representation for a statement that is stable across compiler invocations.

Static Public Member Functions
static CapturedStmt *	Create (const ASTContext &Context, Stmt S, CapturedRegionKind Kind, ArrayRef< Capture > Captures, ArrayRef< Expr > CaptureInits, CapturedDecl CD, RecordDecl RD)

static CapturedStmt *	CreateDeserialized (const ASTContext &Context, unsigned NumCaptures)

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 ()

static Likelihood	getLikelihood (ArrayRef< const Attr * > Attrs)

static Likelihood	getLikelihood (const Stmt *S)

static const Attr *	getLikelihoodAttr (const Stmt *S)

static Likelihood	getLikelihood (const Stmt Then, const Stmt Else)

static std::tuple< bool, const Attr , const Attr >	determineLikelihoodConflict (const Stmt Then, const Stmt Else)

Friends
class	ASTStmtReader

Additional Inherited Members
Protected Types inherited from clang::Stmt
enum	{ NumStmtBits = 8 }

enum	{ NumExprBits = NumStmtBits + 5 + llvm::BitWidth<ExprDependence> }

enum	{ NumCallExprBits = 32 }

enum	{ NumOverloadExprBits = NumExprBits + 1 }

template<typename T >
using	ConstCastIterator = CastIterator< T, const T const, const Stmt const >
	Const iterator for iterating over Stmt * arrays that contain only T *.

using	ExprIterator = CastIterator< Expr >

using	ConstExprIterator = ConstCastIterator< Expr >

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.

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

ConstantExprBitfields ConstantExprBits

PredefinedExprBitfields PredefinedExprBits

DeclRefExprBitfields DeclRefExprBits

FloatingLiteralBitfields FloatingLiteralBits

StringLiteralBitfields StringLiteralBits

CharacterLiteralBitfields CharacterLiteralBits

UnaryOperatorBitfields UnaryOperatorBits

UnaryExprOrTypeTraitExprBitfields UnaryExprOrTypeTraitExprBits

ArrayOrMatrixSubscriptExprBitfields ArrayOrMatrixSubscriptExprBits

CallExprBitfields CallExprBits

MemberExprBitfields MemberExprBits

CastExprBitfields CastExprBits

BinaryOperatorBitfields BinaryOperatorBits

InitListExprBitfields InitListExprBits

ParenListExprBitfields ParenListExprBits

GenericSelectionExprBitfields GenericSelectionExprBits

PseudoObjectExprBitfields PseudoObjectExprBits

SourceLocExprBitfields SourceLocExprBits

StmtExprBitfields StmtExprBits

CXXOperatorCallExprBitfields CXXOperatorCallExprBits

CXXRewrittenBinaryOperatorBitfields CXXRewrittenBinaryOperatorBits

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

LambdaExprBitfields LambdaExprBits

RequiresExprBitfields RequiresExprBits

CoawaitExprBitfields CoawaitBits

ObjCIndirectCopyRestoreExprBitfields ObjCIndirectCopyRestoreExprBits

OpaqueValueExprBitfields OpaqueValueExprBits

};

Detailed Description

This captures a statement into a function.

For example, the following pragma annotated compound statement can be represented as a CapturedStmt, and this compound statement is the body of an anonymous outlined function.

#pragma omp parallel
{
  compute();
}

Definition at line 3767 of file Stmt.h.

Member Typedef Documentation

◆ capture_const_range

using clang::CapturedStmt::capture_const_range = llvm::iterator_range<const_capture_iterator>

Definition at line 3903 of file Stmt.h.

◆ capture_init_iterator

using clang::CapturedStmt::capture_init_iterator = Expr **

Iterator that walks over the capture initialization arguments.

Definition at line 3926 of file Stmt.h.

◆ capture_init_range

using clang::CapturedStmt::capture_init_range = llvm::iterator_range<capture_init_iterator>

Definition at line 3927 of file Stmt.h.

◆ capture_iterator

using clang::CapturedStmt::capture_iterator = Capture *

An iterator that walks over the captures.

Definition at line 3900 of file Stmt.h.

◆ capture_range

using clang::CapturedStmt::capture_range = llvm::iterator_range<capture_iterator>

Definition at line 3902 of file Stmt.h.

◆ const_capture_init_iterator

using clang::CapturedStmt::const_capture_init_iterator = Expr *const *

Const iterator that walks over the capture initialization arguments.

Definition at line 3931 of file Stmt.h.

◆ const_capture_init_range

using clang::CapturedStmt::const_capture_init_range = llvm::iterator_range<const_capture_init_iterator>

Definition at line 3932 of file Stmt.h.

◆ const_capture_iterator

using clang::CapturedStmt::const_capture_iterator = const Capture *

Definition at line 3901 of file Stmt.h.

Member Enumeration Documentation

◆ VariableCaptureKind

enum clang::CapturedStmt::VariableCaptureKind

The different capture forms: by 'this', by reference, capture for variable-length array type etc.

Enumerator
VCK_This
VCK_ByRef
VCK_ByCopy
VCK_VLAType

Definition at line 3771 of file Stmt.h.

Member Function Documentation

◆ capture_begin() [1/2]

capture_iterator clang::CapturedStmt::capture_begin ( )

inline

Retrieve an iterator pointing to the first capture.

Definition at line 3913 of file Stmt.h.

Referenced by captures(), and genMapInfoForCaptures().

◆ capture_begin() [2/2]

const_capture_iterator clang::CapturedStmt::capture_begin ( ) const

inline

Definition at line 3914 of file Stmt.h.

◆ capture_end()

capture_iterator clang::CapturedStmt::capture_end ( ) const

inline

Retrieve an iterator pointing past the end of the sequence of captures.

Definition at line 3918 of file Stmt.h.

Referenced by captures(), and genMapInfoForCaptures().

◆ capture_init_begin() [1/2]

capture_init_iterator clang::CapturedStmt::capture_init_begin ( )

inline

Retrieve the first initialization argument.

Definition at line 3944 of file Stmt.h.

Referenced by capture_init_end(), and capture_inits().

◆ capture_init_begin() [2/2]

const_capture_init_iterator clang::CapturedStmt::capture_init_begin ( ) const

inline

Definition at line 3948 of file Stmt.h.

◆ capture_init_end() [1/2]

capture_init_iterator clang::CapturedStmt::capture_init_end ( )

inline

Retrieve the iterator pointing one past the last initialization argument.

Definition at line 3954 of file Stmt.h.

References capture_init_begin().

Referenced by capture_inits().

◆ capture_init_end() [2/2]

const_capture_init_iterator clang::CapturedStmt::capture_init_end ( ) const

inline

Definition at line 3958 of file Stmt.h.

References capture_init_begin().

◆ capture_inits() [1/2]

capture_init_range clang::CapturedStmt::capture_inits ( )

inline

Definition at line 3935 of file Stmt.h.

References capture_init_begin(), and capture_init_end().

◆ capture_inits() [2/2]

const_capture_init_range clang::CapturedStmt::capture_inits ( ) const

inline

Definition at line 3939 of file Stmt.h.

References capture_init_begin(), and capture_init_end().

◆ capture_size()

unsigned clang::CapturedStmt::capture_size ( ) const

inline

Retrieve the number of captures, including 'this'.

Definition at line 3923 of file Stmt.h.

◆ captures() [1/2]

capture_range clang::CapturedStmt::captures ( )

inline

Definition at line 3905 of file Stmt.h.

References capture_begin(), and capture_end().

Referenced by clang::CodeGen::CGOpenMPRuntimeGPU::adjustTargetSpecificDataForLambdas(), and capturesVariable().

◆ captures() [2/2]

capture_const_range clang::CapturedStmt::captures ( ) const

inline

Definition at line 3908 of file Stmt.h.

References capture_begin(), and capture_end().

◆ capturesVariable()

bool CapturedStmt::capturesVariable ( const VarDecl * Var ) const

True if this variable has been captured.

Definition at line 1431 of file Stmt.cpp.

References captures(), and clang::VarDecl::getCanonicalDecl().

Referenced by clang::CodeGen::CGOpenMPRuntimeGPU::adjustTargetSpecificDataForLambdas(), clang::CodeGen::CGOpenMPRuntime::checkAndEmitSharedLastprivateConditional(), and clang::CapturedStmt::Capture::getCapturedVar().

◆ children() [1/2]

Stmt::child_range CapturedStmt::children ( )

Definition at line 1398 of file Stmt.cpp.

Referenced by isSimdSupportedByOpenMPIRBuilder().

◆ children() [2/2]

Stmt::const_child_range CapturedStmt::children ( ) const

Definition at line 1403 of file Stmt.cpp.

◆ classof()

static bool clang::CapturedStmt::classof ( const Stmt * T )

inlinestatic

Definition at line 3974 of file Stmt.h.

References clang::T.

◆ Create()

CapturedStmt * CapturedStmt::Create	(	const ASTContext &	Context,
		Stmt *	S,
		CapturedRegionKind	Kind,
		ArrayRef< Capture >	Captures,
		ArrayRef< Expr * >	CaptureInits,
		CapturedDecl *	CD,
		RecordDecl *	RD
	)

static

Definition at line 1357 of file Stmt.cpp.

References clang::ASTContext::Allocate().

Referenced by clang::Sema::ActOnCapturedRegionEnd().

◆ CreateDeserialized()

CapturedStmt * CapturedStmt::CreateDeserialized	(	const ASTContext &	Context,
		unsigned	NumCaptures
	)

static

Definition at line 1385 of file Stmt.cpp.

References clang::ASTContext::Allocate().

◆ getBeginLoc()

SourceLocation clang::CapturedStmt::getBeginLoc ( ) const

inline

Definition at line 3962 of file Stmt.h.

References clang::Stmt::getBeginLoc(), and getCapturedStmt().

◆ getCapturedDecl() [1/2]

CapturedDecl * CapturedStmt::getCapturedDecl ( )

Retrieve the outlined function declaration.

Definition at line 1407 of file Stmt.cpp.

Referenced by emitCommonOMPParallelDirective(), emitCommonOMPTeamsDirective(), and setBranchProtectedScope().

◆ getCapturedDecl() [2/2]

const CapturedDecl * CapturedStmt::getCapturedDecl ( ) const

Definition at line 1411 of file Stmt.cpp.

◆ getCapturedRecordDecl()

const RecordDecl * clang::CapturedStmt::getCapturedRecordDecl ( ) const

inline

Retrieve the record declaration for captured variables.

Definition at line 3888 of file Stmt.h.

Referenced by genMapInfoForCaptures().

◆ getCapturedRegionKind()

CapturedRegionKind CapturedStmt::getCapturedRegionKind ( ) const

Retrieve the captured region kind.

Definition at line 1422 of file Stmt.cpp.

◆ getCapturedStmt() [1/2]

Stmt * clang::CapturedStmt::getCapturedStmt ( )

inline

Retrieve the statement being captured.

Definition at line 3871 of file Stmt.h.

Referenced by clang::Sema::ActOnCapturedRegionEnd(), clang::SemaOpenMP::ActOnOpenMPExecutableDirective(), checkSectionsDirective(), emitTargetParallelRegion(), emitTargetTeamsRegion(), getBeginLoc(), getEndLoc(), getNestedDistributeDirective(), clang::CodeGen::CGOpenMPRuntime::getNumTeamsExprForTargetDirective(), getNumThreads(), clang::CodeGen::CGOpenMPRuntime::getNumThreadsExprForTargetDirective(), getSourceRange(), and setBranchProtectedScope().

◆ getCapturedStmt() [2/2]

const Stmt * clang::CapturedStmt::getCapturedStmt ( ) const

inline

Definition at line 3872 of file Stmt.h.

◆ getEndLoc()

SourceLocation clang::CapturedStmt::getEndLoc ( ) const

inline

Definition at line 3966 of file Stmt.h.

References getCapturedStmt(), and clang::Stmt::getEndLoc().

◆ getSourceRange()

SourceRange clang::CapturedStmt::getSourceRange ( ) const

inline

Definition at line 3970 of file Stmt.h.

References getCapturedStmt(), and clang::Stmt::getSourceRange().

◆ setCapturedDecl()

void CapturedStmt::setCapturedDecl ( CapturedDecl * D )

Set the outlined function declaration.

Definition at line 1416 of file Stmt.cpp.

References D.

◆ setCapturedRecordDecl()

void clang::CapturedStmt::setCapturedRecordDecl ( RecordDecl * D )

inline

Set the record declaration for captured variables.

Definition at line 3891 of file Stmt.h.

References D.

◆ setCapturedRegionKind()

void CapturedStmt::setCapturedRegionKind ( CapturedRegionKind Kind )

Set the captured region kind.

Definition at line 1427 of file Stmt.cpp.

Friends And Related Function Documentation

◆ ASTStmtReader

friend class ASTStmtReader

friend

Definition at line 3859 of file Stmt.h.

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

include/clang/AST/Stmt.h
lib/AST/Stmt.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ capture_const_range

◆ capture_init_iterator

◆ capture_init_range

◆ capture_iterator

◆ capture_range

◆ const_capture_init_iterator

◆ const_capture_init_range

◆ const_capture_iterator

Member Enumeration Documentation

◆ VariableCaptureKind

Member Function Documentation

◆ capture_begin() [1/2]

◆ capture_begin() [2/2]

◆ capture_end()

◆ capture_init_begin() [1/2]

◆ capture_init_begin() [2/2]

◆ capture_init_end() [1/2]

◆ capture_init_end() [2/2]

◆ capture_inits() [1/2]

◆ capture_inits() [2/2]

◆ capture_size()

◆ captures() [1/2]

◆ captures() [2/2]

◆ capturesVariable()

◆ children() [1/2]

◆ children() [2/2]

◆ classof()

◆ Create()

◆ CreateDeserialized()

◆ getBeginLoc()

◆ getCapturedDecl() [1/2]

◆ getCapturedDecl() [2/2]

◆ getCapturedRecordDecl()

◆ getCapturedRegionKind()

◆ getCapturedStmt() [1/2]

◆ getCapturedStmt() [2/2]

◆ getEndLoc()

◆ getSourceRange()

◆ setCapturedDecl()

◆ setCapturedRecordDecl()

◆ setCapturedRegionKind()

Friends And Related Function Documentation

◆ ASTStmtReader