com.oracle.truffle.nfi.spi

Class NFIBackendTools

java.lang.Object

com.oracle.truffle.nfi.spi.NFIBackendTools

public abstract class NFIBackendTools
extends Object

Interface providing helper methods for implementing NFI backends.

Constructor Summary

Constructors

Constructor and Description
NFIBackendTools()

Method Summary

Modifier and Type	Method and Description
abstract Object	createBindableSymbol(Object symbol) Create an object wrapping a native symbol, fulfilling the contract of NFI symbols.
abstract Object	createBoundSymbol(Object symbol, Object signature) Create an object wrapping a native symbol that is already bound to a signature.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NFIBackendTools

public NFIBackendTools()

Method Detail

createBindableSymbol

public abstract Object createBindableSymbol(Object symbol)

Create an object wrapping a native symbol, fulfilling the contract of NFI symbols. Symbols passed into this method should implement the NativeSymbolLibrary. The returned object has an invocable member "bind" that can be used to bind NFI signatures to the symbol. It will also forward the InteropLibrary#isPointer, InteropLibrary#asPointer and InteropLibrary#toNative messages to the wrapped symbol. Implementations of NFIBackend should use this method to create the symbols contained in a library. It may also be used for returning pointer values that can point to executable code.

createBoundSymbol

public abstract Object createBoundSymbol(Object symbol,
                                         Object signature)

Create an object wrapping a native symbol that is already bound to a signature. The returned object has the same properties as if created with NFIBackendTools.createBindableSymbol(java.lang.Object). Additionally, it is executable.