evmc::VM Class Reference

The VM instance. More...

#include <evmc.hpp>

Public Member Functions
	VM (evmc_vm *vm) noexcept
	Converting constructor from evmc_vm.
	~VM () noexcept
	Destructor responsible for automatically destroying the VM instance.
	VM (const VM &)=delete
VM &	operator= (const VM &)=delete
	VM (VM &&other) noexcept
	Move constructor.
VM &	operator= (VM &&other) noexcept
	Move assignment operator.
	VM (evmc_vm *vm, std::initializer_list< std::pair< const char *, const char *>> options) noexcept
	The constructor that captures a VM instance and configures the instance with the provided list of options. More...
	operator bool () const noexcept
	Checks if contains a valid pointer to the VM instance.
bool	is_abi_compatible () const noexcept
	Checks whenever the VM instance is ABI compatible with the current EVMC API.
char const *	name () const noexcept
	The name of the EVMC VM implementation. More...
char const *	version () const noexcept
	The version of the EVMC VM implementation, e.g. More...
bool	has_capability (evmc_capabilities capability) const noexcept
	Checks if the VM has the given capability.
evmc_capabilities_flagset	get_capabilities () const noexcept
	The example implementation of the evmc_vm::get_capabilities() method. More...
evmc_set_option_result	set_option (const char name[], const char value[]) noexcept
	Sets the option for the VM, if the feature is supported by the VM. More...
result	execute (const evmc_host_interface &host, evmc_host_context *ctx, evmc_revision rev, const evmc_message &msg, const uint8_t *code, size_t code_size) noexcept
	Executes code in the VM instance. More...
result	execute (Host &host, evmc_revision rev, const evmc_message &msg, const uint8_t *code, size_t code_size) noexcept
	Convenient variant of the VM::execute() that takes reference to evmc::Host class.
result	execute (evmc_revision rev, const evmc_message &msg, const uint8_t *code, size_t code_size) noexcept
	Executes code without the Host context. More...
evmc_vm *	get_raw_pointer () const noexcept
	Returns the pointer to C EVMC struct representing the VM. More...

Detailed Description

The VM instance.

This is a RAII wrapper for evmc_vm, and object of this type automatically destroys the VM instance.

Definition at line 591 of file evmc.hpp.

Constructor & Destructor Documentation

VM()

evmc::VM::VM ( evmc_vm *  vm, std::initializer_list< std::pair< const char *, const char *>>  options  )

inlinenoexcept

The constructor that captures a VM instance and configures the instance with the provided list of options.

Definition at line 705 of file evmc.hpp.

  : m_instance{vm}
{
    // This constructor is implemented outside of the class definition to workaround a doxygen bug.
    for (const auto& option : options)
        set_option(option.first, option.second);
}

Member Function Documentation

execute() [1/2]

result evmc::VM::execute ( const evmc_host_interface &  host, evmc_host_context *  ctx, evmc_revision  rev, const evmc_message &  msg, const uint8_t *  code, size_t  code_size  )

inlinenoexcept

Executes code in the VM instance.

See also

evmc_execute_fn.

Definition at line 657 of file evmc.hpp.

    {
        return result{m_instance->execute(m_instance, &host, ctx, rev, &msg, code, code_size)};
    }

execute() [2/2]

result evmc::VM::execute ( evmc_revision  rev, const evmc_message &  msg, const uint8_t *  code, size_t  code_size  )

inlinenoexcept

Executes code without the Host context.

The same as execute(const evmc_host_interface&, evmc_host_context*, evmc_revision, const evmc_message&, const uint8_t*, size_t), but without providing the Host context and interface. This method is for experimental precompiles support where execution is guaranteed not to require any Host access.

Definition at line 685 of file evmc.hpp.

    {
        return result{
            m_instance->execute(m_instance, nullptr, nullptr, rev, &msg, code, code_size)};
    }

get_capabilities()

evmc_capabilities_flagset evmc::VM::get_capabilities ( ) const

inlinenoexcept

The example implementation of the evmc_vm::get_capabilities() method.

Definition at line 645 of file evmc.hpp.

    {
        return m_instance->get_capabilities(m_instance);
    }

get_raw_pointer()

evmc_vm* evmc::VM::get_raw_pointer ( ) const

inlinenoexcept

Returns the pointer to C EVMC struct representing the VM.

Gives access to the C EVMC VM struct to allow advanced interaction with the VM not supported by the C++ interface. Use as the last resort. This object still owns the VM after returning the pointer. The returned pointer MAY be null.

Definition at line 699 of file evmc.hpp.

{ return m_instance; }

name()

char const* evmc::VM::name ( ) const

inlinenoexcept

The name of the EVMC VM implementation.

It MUST be a NULL-terminated not empty string. The content MUST be UTF-8 encoded (this implies ASCII encoding is also allowed).

Definition at line 633 of file evmc.hpp.

{ return m_instance->name; }

set_option()

evmc_set_option_result evmc::VM::set_option ( const char  name[], const char  value[]  )

inlinenoexcept

Sets the option for the VM, if the feature is supported by the VM.

See also

evmc_set_option_fn

Definition at line 651 of file evmc.hpp.

    {
        return evmc_set_option(m_instance, name, value);
    }

version()

char const* evmc::VM::version ( ) const

inlinenoexcept

The version of the EVMC VM implementation, e.g.

"1.2.3b4".

It MUST be a NULL-terminated not empty string. The content MUST be UTF-8 encoded (this implies ASCII encoding is also allowed).

Definition at line 636 of file evmc.hpp.

{ return m_instance->version; }

---

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

• include/evmc/evmc.hpp