org.graalvm.nativeimage.c.function

Annotation Type CFunction

@Retention(value=RUNTIME)
 @Target(value=METHOD)
public @interface CFunction

Denotes a static native method that calls directly from Java to C, without following the JNI protocol. This means that there are no artificial additional parameters such as the JNI environment passed, and no marshaling or processing of arguments (such as creating handles for objects) is performed.

Parameter and return types must not be Java reference types; only primitive Java values and Word values are allowed. If a Word value is passed that points to a Java object, no guarantees are taken regarding its integrity as a pointer.

The class containing the annotated method must be annotated with CContext.

Since:

1.0

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
CFunction.Transition	transition The Java-to-C thread transition code used when calling the function.
String	value The symbol name to use to link this method.

Element Detail

value

public abstract String value

The symbol name to use to link this method. If no value is specified, the name of the method (without name mangling or a class name prefix) is used.

Since:

1.0

Default:

""

transition

public abstract CFunction.Transition transition

The Java-to-C thread transition code used when calling the function.

Since:

1.0

Default:

org.graalvm.nativeimage.c.function.CFunction.Transition.TO_NATIVE