Bytecode function. More...

#include "/home/buildbot/as-worker-4/publish-doxygen-docs/llvm-project/clang/lib/AST/ByteCode/Function.h"

Public Types
using	ParamDescriptor = std::pair< PrimType, Descriptor * >

using	arg_reverse_iterator = SmallVectorImpl< PrimType >::const_reverse_iterator
	Range over argument types.

Public Member Functions
unsigned	getFrameSize () const
	Returns the size of the function's local stack.

unsigned	getArgSize () const
	Returns the size of the argument stack.

CodePtr	getCodeBegin () const
	Returns a pointer to the start of the code.

CodePtr	getCodeEnd () const
	Returns a pointer to the end of the code.

const FunctionDecl *	getDecl () const
	Returns the original FunctionDecl.

const BlockExpr *	getExpr () const

const std::string	getName () const
	Returns the name of the function decl this code was generated for.

ParamDescriptor	getParamDescriptor (unsigned Offset) const
	Returns a parameter descriptor.

bool	hasRVO () const
	Checks if the first argument is a RVO pointer.

bool	hasNonNullAttr () const

llvm::iterator_range< llvm::SmallVector< Scope, 2 >::const_iterator >	scopes () const
	Range over the scope blocks.

llvm::iterator_range< arg_reverse_iterator >	args_reverse () const

Scope &	getScope (unsigned Idx)
	Returns a specific scope.

const Scope &	getScope (unsigned Idx) const

SourceInfo	getSource (CodePtr PC) const
	Returns the source information at a given PC.

bool	isConstexpr () const
	Checks if the function is valid to call in constexpr.

bool	isVirtual () const
	Checks if the function is virtual.

bool	isConstructor () const
	Checks if the function is a constructor.

bool	isDestructor () const
	Checks if the function is a destructor.

const CXXRecordDecl *	getParentDecl () const
	Returns the parent record decl, if any.

bool	isLambdaStaticInvoker () const
	Returns whether this function is a lambda static invoker, which we generate custom byte code for.

bool	isLambdaCallOperator () const
	Returns whether this function is the call operator of a lambda record decl.

bool	isFullyCompiled () const
	Checks if the function is fully done compiling.

bool	hasThisPointer () const

bool	hasBody () const
	Checks if the function already has a body attached.

bool	isDefined () const
	Checks if the function is defined.

bool	isVariadic () const

unsigned	getBuiltinID () const

bool	isBuiltin () const

bool	isUnevaluatedBuiltin () const

unsigned	getNumParams () const

unsigned	getNumWrittenParams () const
	Returns the number of parameter this function takes when it's called, i.e excluding the instance pointer and the RVO pointer.

unsigned	getWrittenArgSize () const

bool	isThisPointerExplicit () const

unsigned	getParamOffset (unsigned ParamIndex) const

PrimType	getParamType (unsigned ParamIndex) const

void	dump () const
	Dumps the disassembled bytecode to `llvm::errs()`.

void	dump (llvm::raw_ostream &OS) const

Friends
class	Program

class	ByteCodeEmitter

Detailed Description

Bytecode function.

Contains links to the bytecode of the function, as well as metadata describing all arguments and stack-local variables.

Calling Convention

When calling a function, all argument values must be on the stack.

If the function has a This pointer (i.e. hasThisPointer() returns true, the argument values need to be preceeded by a Pointer for the This object.

If the function uses Return Value Optimization, the arguments (and potentially the This pointer) need to be preceeded by a Pointer pointing to the location to construct the returned value.

After the function has been called, it will remove all arguments, including RVO and This pointer, from the stack.

Definition at line 81 of file Function.h.

Member Typedef Documentation

◆ arg_reverse_iterator

using clang::interp::Function::arg_reverse_iterator = SmallVectorImpl<PrimType>::const_reverse_iterator

Range over argument types.

Definition at line 127 of file Function.h.

◆ ParamDescriptor

using clang::interp::Function::ParamDescriptor = std::pair<PrimType, Descriptor *>

Definition at line 83 of file Function.h.

Member Function Documentation

◆ args_reverse()

llvm::iterator_range< arg_reverse_iterator > clang::interp::Function::args_reverse ( ) const

inline

Definition at line 129 of file Function.h.

◆ dump() [1/2]

LLVM_DUMP_METHOD void Function::dump ( ) const

Dumps the disassembled bytecode to llvm::errs().

Definition at line 71 of file Disasm.cpp.

References dump().

◆ dump() [2/2]

LLVM_DUMP_METHOD void Function::dump ( llvm::raw_ostream & OS ) const

Definition at line 73 of file Disasm.cpp.

References getName().

◆ getArgSize()

unsigned clang::interp::Function::getArgSize ( ) const

inline

Returns the size of the argument stack.

Definition at line 88 of file Function.h.

◆ getBuiltinID()

unsigned clang::interp::Function::getBuiltinID ( ) const

inline

Definition at line 196 of file Function.h.

Referenced by clang::interp::interp_floating_comparison(), and isBuiltin().

◆ getCodeBegin()

CodePtr clang::interp::Function::getCodeBegin ( ) const

inline

Returns a pointer to the start of the code.

Definition at line 91 of file Function.h.

Referenced by clang::interp::InterpFrame::getPC().

◆ getCodeEnd()

CodePtr clang::interp::Function::getCodeEnd ( ) const

inline

Returns a pointer to the end of the code.

Definition at line 93 of file Function.h.

◆ getDecl()

const FunctionDecl * clang::interp::Function::getDecl ( ) const

inline

Returns the original FunctionDecl.

Definition at line 96 of file Function.h.

Referenced by clang::interp::CheckCallable(), clang::interp::CheckNonNullArgs(), funcHasUsableBody(), clang::interp::InterpFrame::getCallee(), getName(), clang::interp::Pointer::getSource(), hasNonNullAttr(), clang::interp::interp__builtin_inf(), clang::interp::interp__builtin_nan(), clang::interp::InterpFrame::isStdFunction(), shouldSkipInBacktrace(), and clang::interp::FunctionPointer::toAPValue().

◆ getExpr()

const BlockExpr * clang::interp::Function::getExpr ( ) const

inline

Definition at line 99 of file Function.h.

Referenced by clang::interp::FunctionPointer::toAPValue().

◆ getFrameSize()

unsigned clang::interp::Function::getFrameSize ( ) const

inline

Returns the size of the function's local stack.

Definition at line 86 of file Function.h.

Referenced by clang::interp::InterpFrame::dump().

◆ getName()

const std::string clang::interp::Function::getName ( ) const

inline

Returns the name of the function decl this code was generated for.

Definition at line 105 of file Function.h.

References getDecl(), and clang::NamedDecl::getQualifiedNameAsString().

Referenced by clang::interp::FunctionPointer::print().

◆ getNumParams()

unsigned clang::interp::Function::getNumParams ( ) const

inline

Definition at line 202 of file Function.h.

Referenced by getNumWrittenParams().

◆ getNumWrittenParams()

unsigned clang::interp::Function::getNumWrittenParams ( ) const

inline

Returns the number of parameter this function takes when it's called, i.e excluding the instance pointer and the RVO pointer.

Definition at line 206 of file Function.h.

References getNumParams(), hasRVO(), and hasThisPointer().

◆ getParamDescriptor()

Function::ParamDescriptor Function::getParamDescriptor ( unsigned Offset ) const

Returns a parameter descriptor.

Definition at line 30 of file Function.cpp.

Referenced by clang::interp::InterpFrame::getParamPointer().

◆ getParamOffset()

unsigned clang::interp::Function::getParamOffset ( unsigned ParamIndex ) const

inline

Definition at line 221 of file Function.h.

◆ getParamType()

PrimType clang::interp::Function::getParamType ( unsigned ParamIndex ) const

inline

Definition at line 225 of file Function.h.

◆ getParentDecl()

const CXXRecordDecl * clang::interp::Function::getParentDecl ( ) const

inline

Returns the parent record decl, if any.

Definition at line 158 of file Function.h.

References clang::DeclContext::getParent().

◆ getScope() [1/2]

Scope & clang::interp::Function::getScope ( unsigned Idx )

inline

Returns a specific scope.

Definition at line 134 of file Function.h.

Referenced by clang::interp::InterpFrame::destroy(), and clang::interp::InterpFrame::initScope().

◆ getScope() [2/2]

const Scope & clang::interp::Function::getScope ( unsigned Idx ) const

inline

Definition at line 135 of file Function.h.

◆ getSource()

SourceInfo Function::getSource ( CodePtr PC ) const

Returns the source information at a given PC.

Definition at line 36 of file Function.cpp.

Referenced by clang::interp::EvalEmitter::getSource(), and clang::interp::InterpState::getSource().

◆ getWrittenArgSize()

unsigned clang::interp::Function::getWrittenArgSize ( ) const

inline

Definition at line 210 of file Function.h.

References clang::interp::align(), hasRVO(), hasThisPointer(), clang::interp::primSize(), and clang::interp::PT_Ptr.

◆ hasBody()

bool clang::interp::Function::hasBody ( ) const

inline

Checks if the function already has a body attached.

Definition at line 189 of file Function.h.

Referenced by clang::interp::CheckCallable(), and clang::interp::EvalEmitter::getSource().

◆ hasNonNullAttr()

bool clang::interp::Function::hasNonNullAttr ( ) const

inline

Definition at line 118 of file Function.h.

References getDecl(), and clang::Decl::hasAttr().

◆ hasRVO()

bool clang::interp::Function::hasRVO ( ) const

inline

Checks if the first argument is a RVO pointer.

Definition at line 116 of file Function.h.

Referenced by clang::interp::InterpFrame::describe(), getNumWrittenParams(), getWrittenArgSize(), and clang::interp::Compiler< Emitter >::VisitCXXInheritedCtorInitExpr().

◆ hasThisPointer()

bool clang::interp::Function::hasThisPointer ( ) const

inline

Definition at line 186 of file Function.h.

Referenced by clang::interp::InterpFrame::describe(), getNumWrittenParams(), getWrittenArgSize(), and clang::interp::Compiler< Emitter >::VisitCXXInheritedCtorInitExpr().

◆ isBuiltin()

bool clang::interp::Function::isBuiltin ( ) const

inline

Definition at line 198 of file Function.h.

References getBuiltinID().

Referenced by shouldSkipInBacktrace().

◆ isConstexpr()

bool clang::interp::Function::isConstexpr ( ) const

inline

Checks if the function is valid to call in constexpr.

Definition at line 141 of file Function.h.

References isLambdaStaticInvoker().

Referenced by clang::interp::CheckCallable().

◆ isConstructor()

bool clang::interp::Function::isConstructor ( ) const

inline

Checks if the function is a constructor.

Definition at line 147 of file Function.h.

Referenced by funcHasUsableBody().

◆ isDefined()

bool clang::interp::Function::isDefined ( ) const

inline

Checks if the function is defined.

Definition at line 192 of file Function.h.

◆ isDestructor()

bool clang::interp::Function::isDestructor ( ) const

inline

Checks if the function is a destructor.

Definition at line 152 of file Function.h.

Referenced by funcHasUsableBody().

◆ isFullyCompiled()

bool clang::interp::Function::isFullyCompiled ( ) const

inline

Checks if the function is fully done compiling.

Definition at line 184 of file Function.h.

◆ isLambdaCallOperator()

bool clang::interp::Function::isLambdaCallOperator ( ) const

inline

Returns whether this function is the call operator of a lambda record decl.

Definition at line 176 of file Function.h.

References clang::isLambdaCallOperator().

◆ isLambdaStaticInvoker()

bool clang::interp::Function::isLambdaStaticInvoker ( ) const

inline

Returns whether this function is a lambda static invoker, which we generate custom byte code for.

Definition at line 167 of file Function.h.

Referenced by clang::interp::CheckCallable(), isConstexpr(), and shouldSkipInBacktrace().

◆ isThisPointerExplicit()

bool clang::interp::Function::isThisPointerExplicit ( ) const

inline

Definition at line 214 of file Function.h.

◆ isUnevaluatedBuiltin()

bool Function::isUnevaluatedBuiltin ( ) const

Definition at line 67 of file Function.cpp.

◆ isVariadic()

bool clang::interp::Function::isVariadic ( ) const

inline

Definition at line 194 of file Function.h.

◆ isVirtual()

bool Function::isVirtual ( ) const

Checks if the function is virtual.

Definition at line 48 of file Function.cpp.

Referenced by clang::interp::CheckCallable().

◆ scopes()

llvm::iterator_range< llvm::SmallVector< Scope, 2 >::const_iterator > clang::interp::Function::scopes ( ) const

inline

Range over the scope blocks.

Definition at line 122 of file Function.h.

Referenced by clang::interp::InterpFrame::~InterpFrame().

Friends And Related Function Documentation

◆ ByteCodeEmitter

friend class ByteCodeEmitter

friend

Definition at line 254 of file Function.h.

◆ Program

friend class Program

friend

Definition at line 253 of file Function.h.

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

lib/AST/ByteCode/Function.h
lib/AST/ByteCode/Disasm.cpp
lib/AST/ByteCode/Function.cpp

Public Types

Public Member Functions

Friends

Detailed Description

Calling Convention

Member Typedef Documentation

◆ arg_reverse_iterator

◆ ParamDescriptor

Member Function Documentation

◆ args_reverse()

◆ dump() [1/2]

◆ dump() [2/2]

◆ getArgSize()

◆ getBuiltinID()

◆ getCodeBegin()

◆ getCodeEnd()

◆ getDecl()

◆ getExpr()

◆ getFrameSize()

◆ getName()

◆ getNumParams()

◆ getNumWrittenParams()

◆ getParamDescriptor()

◆ getParamOffset()

◆ getParamType()

◆ getParentDecl()

◆ getScope() [1/2]

◆ getScope() [2/2]

◆ getSource()

◆ getWrittenArgSize()

◆ hasBody()

◆ hasNonNullAttr()

◆ hasRVO()

◆ hasThisPointer()

◆ isBuiltin()

◆ isConstexpr()

◆ isConstructor()

◆ isDefined()

◆ isDestructor()

◆ isFullyCompiled()

◆ isLambdaCallOperator()

◆ isLambdaStaticInvoker()

◆ isThisPointerExplicit()

◆ isUnevaluatedBuiltin()

◆ isVariadic()

◆ isVirtual()

◆ scopes()

Friends And Related Function Documentation

◆ ByteCodeEmitter

◆ Program