Description

The compiler detail class for VuoType.

Definition at line 20 of file VuoCompilerType.hh.

Public Member Functions
Value *	generateValueFromStringFunctionCall (Module module, BasicBlock block, Value *arg)
	Generates a call to [Type]_makeFromString(). More...

Value *	generateStringFromValueFunctionCall (Module module, BasicBlock block, Value *arg)
	Generates a call to [Type]_getString(). More...

Value *	generateInterprocessStringFromValueFunctionCall (Module module, BasicBlock block, Value *arg)
	Generates a call to [Type]_getInterprocessString(). More...

Value *	generateSummaryFromValueFunctionCall (Module module, BasicBlock block, Value *arg)
	Generates a call to [Type]_getSummary(). More...

void	generateRetainCall (Module module, BasicBlock block, Value *arg)
	Generates a call to [Type]_retain(), if needed. More...

void	generateReleaseCall (Module module, BasicBlock block, Value *arg)
	Generates a call to [Type]_release(), if needed. More...

vector< Value * >	convertPortDataToArgs (Module module, BasicBlock block, Value arg, FunctionType functionType, int parameterIndex, bool isUnloweredStructPointerParameter)
	Generates an argument or arguments representing the port data, lowered for the C ABI. More...

Value *	convertArgsToPortData (Module module, BasicBlock block, Function *function, int parameterIndex)
	Unlowers the function argument at parameterIndex (and the one after, if this data type is lowered to 2 arguments) into port data (the same data type as `portContext->data`). More...

size_t	getSize (Module *module)
	Returns this type's storage size in bytes. More...

Value *	convertToPortData (BasicBlock block, Value voidPointer)
	Casts a `void *` to a pointer to this type's storage. More...

bool	isRetainOrReleaseNeeded ()
	Returns true if this type is itself reference-counted, or may have structure members that are reference-counted. More...

vector< Type * >	getFunctionParameterTypes (void)
	Returns the LLVM type(s) for when this Vuo type is passed to a function. More...

PointerType *	getFunctionParameterPointerType (void)
	Returns the LLVM type for when a pointer to this Vuo type is passed to a function. More...

AttributeList	getFunctionAttributes (void)
	Returns the LLVM attributes for this Vuo type when it appears as a function parameter. More...

void	copyFunctionParameterAttributes (Function *dstFunction)
	Copies the LLVM attributes for this Vuo type as a function parameter onto the parameter(s) of dstFunction. More...

void	copyFunctionParameterAttributes (Module module, CallInst dstCall)
	Copies the LLVM attributes for this Vuo type as a function parameter onto the parameter(s) of dstCall. More...

bool	hasInterprocessStringFunction (void)
	Returns true if the type's `getInterprocessString()` function is defined. More...

bool	supportsComparison (void)
	Returns true if the type's `areEqual` and `isLessThan` functions are defined. More...

Public Member Functions inherited from VuoBaseDetail< VuoType >
	VuoBaseDetail (string description, VuoType *base)
	Creates a detail class. More...

VuoType *	getBase (void) const
	Returns the detail class instance's base class instance. More...

void	setBase (VuoType *base)
	Sets the detail class instance's base class instance. More...

Public Member Functions inherited from VuoCompilerModule
virtual	~VuoCompilerModule (void)
	Destructor. More...

VuoCompilerCompatibility	parseCompatibility (json_object *o, string key)
	Parses the target set value for key in the top level of the JSON object. More...

virtual set< string >	getDependencies (void)
	Returns a list of this VuoCompilerModule's dependencies. More...

virtual string	getDependencyName (void)
	Returns the name that would represent this VuoCompilerModule in another VuoCompilerModule's list of dependencies. More...

VuoCompilerCompatibility	getCompatibleTargets (void)
	Returns the set of targets (operating system versions) with which this module is compatible. More...

Module *	getModule (void)
	Returns this VuoCompilerModule's LLVM module, which other LLVM modules can link to. More...

VuoModule *	getPseudoBase (void)
	Returns the (pseudo) base for this (pseudo) compiler detail class. More...

bool	isBuiltIn (void)
	Returns true if this module is one of the built-in modules distributed with Vuo. More...

void	setBuiltIn (bool builtIn)
	Sets whether this module is one of the built-in modules distributed with Vuo. More...

string	getModulePath (void)
	Returns the file from which the LLVM module was loaded, or an empty string if the module was contained in an archive or generated by the compiler. More...

Static Public Member Functions
static VuoCompilerType *	newType (string typeName, Module *module)
	Creates a type from the type definition in the module. More...

static bool	isListType (VuoCompilerType *type)
	Returns true if the type is a list type. More...

Static Public Member Functions inherited from VuoCompilerModule
static VuoCompilerModule *	newModule (const string &moduleKey, Module *module, const string &modulePath, const VuoCompilerCompatibility &moduleCompatibility)
	Instantiates a VuoCompilerModule (or child class) corresponding to the type of VuoCompilerModule defined in the LLVM module. More...

static Function *	declareFunctionInModule (Module module, Function function)
	Copies the function's header into the LLVM module, if it's not already there. More...

Protected Member Functions
	VuoCompilerType (string typeName, Module *module)
	Creates a type from an LLVM module, and creates its corresponding base `VuoType`. More...

Protected Member Functions inherited from VuoCompilerModule
	VuoCompilerModule (VuoModule base, Module module)
	Creates a VuoCompilerModule associated with the given LLVM module, as a pseudo compiler detail class of the given VuoModule. More...

virtual void	parseMetadata (void)
	Parses the metadata of this VuoCompilerModule (name, description, ...) from the LLVM module. More...

string	nameForGlobal (string genericGlobalVarOrFuncName)
	Returns the mangled name for a function or global variable. More...

void	renameGlobalVarsAndFuncs (void)
	Renames the global variables and functions within the LLVM module so that they are unique to this VuoCompilerModule. More...

Friends
class	TestVuoCompilerType

class	TestTypes

Additional Inherited Members
Static Protected Member Functions inherited from VuoCompilerModule
static string	nameForGlobal (string nameBeforeCompilation, string moduleKey)
	Returns the mangled name for a function or global variable. More...

static bool	hasOriginalOrMangledGlobal (string nameBeforeCompilation, Module *module, string moduleKey)
	Returns true if the module contains a function or global variable with name `nameBeforeCompilation` or with the corresponding mangled name. More...

Protected Attributes inherited from VuoCompilerModule
struct json_object *	moduleDetails
	This module's metadata, found in the argument to `VuoModuleMetadata` in the module definition. More...

set< string >	dependencies
	The dependencies found in this module's metadata. More...

VuoCompilerCompatibility	compatibleTargets
	The set of targets with which this module is compatible. More...

Module *	module
	The LLVM module that defines this node class or type. More...

VuoCompilerBitcodeParser *	parser
	The parser of the LLVM module. More...

Constructor & Destructor Documentation

◆ VuoCompilerType()

VuoCompilerType::VuoCompilerType	(	string	typeName,
		Module *	module
	)

protected

Creates a type from an LLVM module, and creates its corresponding base VuoType.

Definition at line 21 of file VuoCompilerType.cc.

Member Function Documentation

◆ convertArgsToPortData()

Value * VuoCompilerType::convertArgsToPortData	(	Module *	module,
		BasicBlock *	block,
		Function *	function,
		int	parameterIndex
	)

Unlowers the function argument at parameterIndex (and the one after, if this data type is lowered to 2 arguments) into port data (the same data type as portContext->data).

Definition at line 524 of file VuoCompilerType.cc.

◆ convertPortDataToArgs()

vector< Value * > VuoCompilerType::convertPortDataToArgs	(	Module *	module,
		BasicBlock *	block,
		Value *	arg,
		FunctionType *	functionType,
		int	parameterIndex,
		bool	isUnloweredStructPointerParameter
	)

Generates an argument or arguments representing the port data, lowered for the C ABI.

arg should be the same data type as portContext->data.

Definition at line 457 of file VuoCompilerType.cc.

◆ convertToPortData()

Value * VuoCompilerType::convertToPortData	(	BasicBlock *	block,
		Value *	voidPointer
	)

Casts a void * to a pointer to this type's storage.

Definition at line 598 of file VuoCompilerType.cc.

◆ copyFunctionParameterAttributes() [1/2]

void VuoCompilerType::copyFunctionParameterAttributes ( Function * dstFunction )

Copies the LLVM attributes for this Vuo type as a function parameter onto the parameter(s) of dstFunction.

Definition at line 649 of file VuoCompilerType.cc.

◆ copyFunctionParameterAttributes() [2/2]

void VuoCompilerType::copyFunctionParameterAttributes	(	Module *	module,
		CallInst *	dstCall
	)

Copies the LLVM attributes for this Vuo type as a function parameter onto the parameter(s) of dstCall.

Definition at line 657 of file VuoCompilerType.cc.

◆ generateInterprocessStringFromValueFunctionCall()

Value * VuoCompilerType::generateInterprocessStringFromValueFunctionCall	(	Module *	module,
		BasicBlock *	block,
		Value *	arg
	)

Generates a call to [Type]_getInterprocessString().

Parameters

module	The destination LLVM module (i.e., generated code).
block	The LLVM block to which to append the function call.
arg	The argument to pass to [Type]_getInterprocessString().

Returns: The return value of [Type]_getInterprocessString(), or the return value of [Type]_getString() if the interprocess function doesn't exist.

Definition at line 413 of file VuoCompilerType.cc.

◆ generateReleaseCall()

void VuoCompilerType::generateReleaseCall	(	Module *	module,
		BasicBlock *	block,
		Value *	arg
	)

Generates a call to [Type]_release(), if needed.

Definition at line 446 of file VuoCompilerType.cc.

◆ generateRetainCall()

void VuoCompilerType::generateRetainCall	(	Module *	module,
		BasicBlock *	block,
		Value *	arg
	)

Generates a call to [Type]_retain(), if needed.

Definition at line 437 of file VuoCompilerType.cc.

◆ generateStringFromValueFunctionCall()

Value * VuoCompilerType::generateStringFromValueFunctionCall	(	Module *	module,
		BasicBlock *	block,
		Value *	arg
	)

Generates a call to [Type]_getString().

Parameters

module	The destination LLVM module (i.e., generated code).
block	The LLVM block to which to append the function call.
arg	The argument to pass to [Type]_getString().

Returns: The return value of [Type]_getString().

Definition at line 400 of file VuoCompilerType.cc.

◆ generateSummaryFromValueFunctionCall()

Value * VuoCompilerType::generateSummaryFromValueFunctionCall	(	Module *	module,
		BasicBlock *	block,
		Value *	arg
	)

Generates a call to [Type]_getSummary().

Parameters

module	The destination LLVM module (i.e., generated code).
block	The LLVM block to which to append the function call.
arg	The argument to pass to [Type]_getSummary().

Returns: The return value of [Type]_getSummary().

Definition at line 429 of file VuoCompilerType.cc.

◆ generateValueFromStringFunctionCall()

Value * VuoCompilerType::generateValueFromStringFunctionCall	(	Module *	module,
		BasicBlock *	block,
		Value *	arg
	)

Generates a call to [Type]_makeFromString().

Parameters

module	The destination LLVM module (i.e., generated code).
block	The LLVM block to which to append the function call.
arg	The argument to pass to [Type]_makeFromString().

Returns: The return value of [Type]_makeFromString().

Definition at line 374 of file VuoCompilerType.cc.

◆ getFunctionAttributes()

AttributeList VuoCompilerType::getFunctionAttributes ( void )

Returns the LLVM attributes for this Vuo type when it appears as a function parameter.

This is needed, for example, for struct parameters with the "byval" attribute.

Definition at line 641 of file VuoCompilerType.cc.

◆ getFunctionParameterPointerType()

PointerType * VuoCompilerType::getFunctionParameterPointerType ( void )

Returns the LLVM type for when a pointer to this Vuo type is passed to a function.

Definition at line 631 of file VuoCompilerType.cc.

◆ getFunctionParameterTypes()

vector< Type * > VuoCompilerType::getFunctionParameterTypes ( void )

Returns the LLVM type(s) for when this Vuo type is passed to a function.

Definition at line 619 of file VuoCompilerType.cc.

◆ getSize()

size_t VuoCompilerType::getSize ( Module * module )

Returns this type's storage size in bytes.

Definition at line 585 of file VuoCompilerType.cc.

◆ hasInterprocessStringFunction()

bool VuoCompilerType::hasInterprocessStringFunction ( void )

Returns true if the type's getInterprocessString() function is defined.

Definition at line 676 of file VuoCompilerType.cc.

◆ isListType()

bool VuoCompilerType::isListType ( VuoCompilerType * type )

static

Returns true if the type is a list type.

Definition at line 665 of file VuoCompilerType.cc.

◆ isRetainOrReleaseNeeded()

bool VuoCompilerType::isRetainOrReleaseNeeded ( )

Returns true if this type is itself reference-counted, or may have structure members that are reference-counted.

Definition at line 611 of file VuoCompilerType.cc.

◆ newType()

VuoCompilerType * VuoCompilerType::newType	(	string	typeName,
		Module *	module
	)

static

Creates a type from the type definition in the module.

If the module does not contain a type definition, returns NULL.

Definition at line 50 of file VuoCompilerType.cc.

◆ supportsComparison()

bool VuoCompilerType::supportsComparison ( void )

Returns true if the type's areEqual and isLessThan functions are defined.

Definition at line 684 of file VuoCompilerType.cc.

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

compiler/VuoCompilerType.hh
compiler/VuoCompilerType.cc

Description

Public Member Functions

Static Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Constructor & Destructor Documentation

◆ VuoCompilerType()

Member Function Documentation

◆ convertArgsToPortData()

◆ convertPortDataToArgs()

◆ convertToPortData()

◆ copyFunctionParameterAttributes() [1/2]

◆ copyFunctionParameterAttributes() [2/2]

◆ generateInterprocessStringFromValueFunctionCall()

◆ generateReleaseCall()

◆ generateRetainCall()

◆ generateStringFromValueFunctionCall()

◆ generateSummaryFromValueFunctionCall()

◆ generateValueFromStringFunctionCall()

◆ getFunctionAttributes()

◆ getFunctionParameterPointerType()

◆ getFunctionParameterTypes()

◆ getSize()

◆ hasInterprocessStringFunction()

◆ isListType()

◆ isRetainOrReleaseNeeded()

◆ newType()

◆ supportsComparison()