Loads a program, and lets the user execute its functions. More...

Classes
struct	FunctionExecutionContext

Public Types
enum	ErrorCode : uint8 { ErrorCode::ok = 0, ErrorCode::executionTimedOut, ErrorCode::unknownInstruction, ErrorCode::stackOverflow, ErrorCode::stackUnderflow, ErrorCode::illegalAddress, ErrorCode::divisionByZero, ErrorCode::unknownFunction }
	Return codes from a function call. More...

Public Member Functions
	Runner () noexcept

void	setNativeFunctions (const NativeFunction functions, int numFunctions, void userDataForCallback) noexcept
	Installs an array of native functions that the code can use. More...

int	getNumNativeFunctions () const noexcept
	Returns the number of native functions available. More...

const NativeFunction &	getNativeFunction (int index) const noexcept
	Returns one of the native functions available. More...

void	reset () noexcept
	Clears the memory state. More...

void	clearHeapAndGlobals () noexcept
	Clears all the non-program data. More...

ErrorCode	callFunction (const char *functionSignature) noexcept
	Calls one of the functions in the program, by its textual signature. More...

ErrorCode	callFunction (FunctionID function) noexcept
	Calls one of the functions in the program, by its function ID. More...

uint8 *	getProgramAndDataStart () const noexcept

uint8 *	getProgramAndDataEnd () const noexcept

uint32	getProgramAndDataSize () const noexcept

uint8 *	getProgramHeapStart () const noexcept

uint8 *	getProgramHeapEnd () const noexcept

uint16	getProgramHeapSize () const noexcept

bool	isProgramValid () const noexcept

void	setDataByte (uint32 index, uint8 value) noexcept
	Sets a byte of data. More...

void	setHeapByte (uint32 index, uint8 value) noexcept

uint8	getHeapByte (uint32 index) const noexcept

uint32	getHeapBits (uint32 startBit, uint32 numBits) const noexcept

int32	setHeapInt (uint32 byteOffset, uint32 value) noexcept

int32	getHeapInt (uint32 byteOffset) const noexcept

Static Public Member Functions
static const char *	getErrorDescription (ErrorCode e) noexcept
	Returns a text description for an error code. More...

static uint32	getMaximumProgramSize () noexcept

Public Attributes
uint8	allMemory [(size_t)(((programAndHeapSpace+stackAndGlobalsSpace)+3) &~3)]

Program	program

Static Public Attributes
static constexpr uint32	totalProgramAndHeapSpace = programAndHeapSpace

static constexpr uint32	totalStackAndGlobalsSpace = stackAndGlobalsSpace

Detailed Description

template<int programAndHeapSpace, int stackAndGlobalsSpace>
struct littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >

Loads a program, and lets the user execute its functions.

The programAndHeapSpace is the number of bytes allocated for program + heap. stackAndGlobalsSpace is the size of the globals + stack area.

Memory layout:

Program code goes at address 0, followed by any shared data the program needs globals are at the top end of the buffer stack space stretches downwards from the start of the globals

Member Enumeration Documentation

◆ ErrorCode

template<int programAndHeapSpace, int stackAndGlobalsSpace>

enum littlefoot::Runner::ErrorCode : uint8

strong

Return codes from a function call.

Enumerator
ok
executionTimedOut
unknownInstruction
stackOverflow
stackUnderflow
illegalAddress
divisionByZero
unknownFunction

Constructor & Destructor Documentation

◆ Runner()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::Runner ( )

noexcept

Member Function Documentation

◆ setNativeFunctions()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

void littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::setNativeFunctions	(	const NativeFunction *	functions,
		int	numFunctions,
		void *	userDataForCallback
	)

noexcept

Installs an array of native functions that the code can use.

Note that this doesn't take ownership of any memory involved, so the caller mustn't pass any dangling pointers

◆ getNumNativeFunctions()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

int littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getNumNativeFunctions ( ) const

noexcept

Returns the number of native functions available.

◆ getNativeFunction()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

const NativeFunction& littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getNativeFunction ( int index ) const

noexcept

Returns one of the native functions available.

The index must not be out of range.

References jassert.

◆ reset()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

void littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::reset ( )

noexcept

Clears the memory state.

◆ clearHeapAndGlobals()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

void littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::clearHeapAndGlobals ( )

noexcept

Clears all the non-program data.

◆ getErrorDescription()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

static const char* littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getErrorDescription ( ErrorCode e )

staticnoexcept

Returns a text description for an error code.

◆ callFunction() [1/2]

template<int programAndHeapSpace, int stackAndGlobalsSpace>

ErrorCode littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::callFunction ( const char * functionSignature )

noexcept

Calls one of the functions in the program, by its textual signature.

References littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

◆ callFunction() [2/2]

template<int programAndHeapSpace, int stackAndGlobalsSpace>

ErrorCode littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::callFunction ( FunctionID function )

noexcept

Calls one of the functions in the program, by its function ID.

References littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

◆ getMaximumProgramSize()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

static uint32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getMaximumProgramSize ( )

staticnoexcept

◆ getProgramAndDataStart()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint8* littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getProgramAndDataStart ( ) const

noexcept

◆ getProgramAndDataEnd()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint8* littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getProgramAndDataEnd ( ) const

noexcept

◆ getProgramAndDataSize()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getProgramAndDataSize ( ) const

noexcept

◆ getProgramHeapStart()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint8* littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getProgramHeapStart ( ) const

noexcept

◆ getProgramHeapEnd()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint8* littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getProgramHeapEnd ( ) const

noexcept

◆ getProgramHeapSize()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint16 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getProgramHeapSize ( ) const

noexcept

◆ isProgramValid()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

bool littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::isProgramValid ( ) const

noexcept

◆ setDataByte()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

void littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::setDataByte	(	uint32	index,
		uint8	value
	)

noexcept

Sets a byte of data.

◆ setHeapByte()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

void littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::setHeapByte	(	uint32	index,
		uint8	value
	)

noexcept

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

◆ getHeapByte()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint8 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getHeapByte ( uint32 index ) const

noexcept

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

◆ getHeapBits()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getHeapBits	(	uint32	startBit,
		uint32	numBits
	)		const

noexcept

References jassertfalse, and readLittleEndianBitsInBuffer().

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

◆ setHeapInt()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

int32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::setHeapInt	(	uint32	byteOffset,
		uint32	value
	)

noexcept

References littlefoot::Program::writeInt32().

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

◆ getHeapInt()

template<int programAndHeapSpace, int stackAndGlobalsSpace>

int32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::getHeapInt ( uint32 byteOffset ) const

noexcept

References littlefoot::Program::readInt32().

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

Member Data Documentation

◆ totalProgramAndHeapSpace

template<int programAndHeapSpace, int stackAndGlobalsSpace>

constexpr uint32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::totalProgramAndHeapSpace = programAndHeapSpace

static

◆ totalStackAndGlobalsSpace

template<int programAndHeapSpace, int stackAndGlobalsSpace>

constexpr uint32 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::totalStackAndGlobalsSpace = stackAndGlobalsSpace

static

◆ allMemory

template<int programAndHeapSpace, int stackAndGlobalsSpace>

uint8 littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::allMemory[(size_t)(((programAndHeapSpace+stackAndGlobalsSpace)+3) &~3)]

◆ program

template<int programAndHeapSpace, int stackAndGlobalsSpace>

Program littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::program

Referenced by littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >::FunctionExecutionContext::run().

The documentation for this struct was generated from the following file:

juce_LittleFootRunner.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

template<int programAndHeapSpace, int stackAndGlobalsSpace> struct littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >

Member Enumeration Documentation

◆ ErrorCode

Constructor & Destructor Documentation

◆ Runner()

Member Function Documentation

◆ setNativeFunctions()

◆ getNumNativeFunctions()

◆ getNativeFunction()

◆ reset()

◆ clearHeapAndGlobals()

◆ getErrorDescription()

◆ callFunction() [1/2]

◆ callFunction() [2/2]

◆ getMaximumProgramSize()

◆ getProgramAndDataStart()

◆ getProgramAndDataEnd()

◆ getProgramAndDataSize()

◆ getProgramHeapStart()

◆ getProgramHeapEnd()

◆ getProgramHeapSize()

◆ isProgramValid()

◆ setDataByte()

◆ setHeapByte()

◆ getHeapByte()

◆ getHeapBits()

◆ setHeapInt()

◆ getHeapInt()

Member Data Documentation

◆ totalProgramAndHeapSpace

◆ totalStackAndGlobalsSpace

◆ allMemory

◆ program

template<int programAndHeapSpace, int stackAndGlobalsSpace>
struct littlefoot::Runner< programAndHeapSpace, stackAndGlobalsSpace >