Skip to content
This repository

Java Abstracted Foreign Function Layer

README.md

jnr-ffi Build Status

jnr-ffi is a java library for loading native libraries without writing JNI code by hand, or using tools such as SWIG.

Example

package helloworld;

import jnr.ffi.LibraryLoader;

public class HelloWorld {
    public static interface LibC {
        int puts(String s);
    }

    public static void main(String[] args) {
        LibC libc = LibraryLoader.create(LibC.class).load("c");

        libc.puts("Hello, World");
    }
}

Supported Types

All java primitives are mapped simply to the equivalent C types.

  • byte - 8 bit signed integer
  • short - 16 bit signed integer
  • int - 32 bit signed integer
  • long - natural long (i.e. 32 bits wide on 32 bit systems, 64 bit wide on 64bit systems)
  • float - 32 bit float
  • double - 64 bit float

The width and/or signed-ness of these basic types can be specified using one of the type alias annotations. e.g.

// Use the correct width for the result from getpid(3)
@pid_t long getpid();

// read(2) returns a signed long result, and its length parameter is an unsigned long
@ssize_t long read(int fd, Pointer data, @size_t long len);

In addition, the following java types are mapped to a C pointer

  • String - equivalent to "const char *"
  • Pointer - equivalent to "void *"
  • Buffer - equivalent to "void *"
Something went wrong with that request. Please try again.