A collection of ISO C binding interfaces to Lua 5.4 for Fortran 2008, to call Lua from Fortran and vice versa.

Similar projects:

• AOTUS: Library that provides a Fortran wrapper to use Lua scripts as configuration files (MIT).
• FortLua: Example that shows how to load Lua configuration files from Fortran, based on AOTUS (MIT).
• fortran-lua53: Fortran 2008 bindings to Lua 5.3 (ISC).
• f2k3-lua: Lua bindings for loading configuration files only (MIT).
• luaf: Selected bindings to Lua 5.1 (MIT).

Install Lua 5.4 with development headers. On FreeBSD, run:

# pkg install devel/pkgconf lang/lua54 

On Debian Linux, install:

# apt-get install pkg-config liblua5.4 liblua5.4-dev 

Use xmake to build fortran-lua54:

$ xmake 

This outputs libfortran-lua54.a and lua.mod to build/. Without xmake, just compile and install the library using the provided Makefile:

$ make $ make install PREFIX=/opt 

Or, run the Fortran Package Manager:

$ fpm build --profile release 

Link your Fortran applications against libfortran-lua54.a, and liblua-5.4.a or -llua54. On Linux, you have to link against liblua5.4.a or -llua5.4 respectively instead. The include and library search paths may differ as well.

The following basic example shows how to call the Lua function hello() in script.lua from Fortran.

-- script.lua function hello() print('Hello from Lua!') end

Make sure that script.lua is stored in the same directory as the Fortran application.

! example.f90 program main use, intrinsic :: iso_c_binding use :: lua implicit none type(c_ptr) :: l integer :: rc l = lual_newstate() call lual_openlibs(l) rc = lual_dofile(l, 'script.lua') rc = lua_getglobal(l, 'hello') rc = lua_pcall(l, 0, 0, 0) call lua_close(l) end program main

If the the interface bindings are installed to /opt, then compile, link, and run the example with:

$ gfortran -I/opt/include/libfortran-lua54/ -L/usr/local/lib/lua/5.4/ \ -o example example.f90 /opt/lib/libfortran-lua54.a -llua-5.4 $ ./example Hello from Lua! 

On Linux, change the prefix /usr/local to /usr. To link Lua 5.4 statically, run instead:

$ gfortran -o example example.f90 libfortran-lua54.a /usr/local/lib/liblua-5.4.a 

Additional examples can be found in examples/.

• fibonacci: calls a recursive Lua routine loaded from file.
• library: calls a Fortran routine inside a shared library from Lua (copy fortran.so to share/, then run share/library.lua).
• string: runs Lua code stored in a Fortran string.
• table: reads values from a Lua table.

You can add fortran-lua54 as an FPM dependency:

[dependencies] fortran-lua54 = { git = "https://github.com/interkosmos/fortran-lua54.git" }

The integer and float types used by Lua internally depend on the targeted platform. The program test/types.c outputs the types:

$ make test $ ./types lua_integer.: c_long_long lua_number..: c_double lua_kcontext: c_intptr_t 

You may have to alter lua_integer, lua_number, and lua_kcontext in src/lua.f90 accordingly.

ISC