Denotes Java interface that imports a C struct. The interface must extend PointerBase, i.e., it is a word type. There is never a Java class that implements the interface.

Field accesses are done via interface methods that are annotated with CField, CFieldAddress, or CFieldOffset. All calls of the interface methods are replaced with the appropriate memory or address arithmetic operations. Here is an example to define a complex number structure:

The annotated interface, or an outer class that contains the interface, must be annotated with CContext. Allocate an instances of the struct either by org.graalvm.nativeimage.StackValue#get(java.lang.Class) or by org.graalvm.nativeimage.UnmanagedMemory#malloc(org.graalvm.word.UnsignedWord). To access an array of structs one can define a special addressOf method:

Implementation of such method then allows one to do array arithmetics - e.g. obtain pointer to the first element of the array and then access the others: