Repository files navigation

A collection of ISO C binding interfaces to Lua 5.3 for Fortran 2008, to callLua 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-lua54: Fortran 2008 bindings to Lua 5.4 (ISC).
• f2k3-lua: Lua bindings for loading configuration files only (MIT).
• luaf: Selected bindings to Lua 5.1 (MIT).

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

# pkg install lang/lua53

On Debian Linux, install:

# apt-get install liblua5.3 liblua5.3-dev

Usexmake to buildfortran-lua53:

$ xmake

This outputslibfortran-lua53.a andlua.mod tobuild/. Without xmake, justcompile the library using the providedMakefile:

$ make

Or, run the Fortran Package Manager:

$ fpm build --profile=release

Link your Fortran applications againstlibfortran-lua53.a, andliblua-5.3.a or-llua53. On Linux, you have to link againstliblua5.3.a or-llua5.3 respectively instead. The include and library search paths may differas well.

The following basic example shows how to call the Lua functionhello() inscript.lua from Fortran.

-- script.luafunctionhello()print('Hello from Lua!')end

Make sure thatscript.lua is stored in the same directory as the Fortranapplication.

! example.f90program main    use,intrinsic:: iso_c_binding, only: c_ptr    use:: luaimplicit none    type(c_ptr):: linteger:: 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

Compile, (dynamically) link, and run the example with:

$ gfortran -I/usr/local/include/lua53/ -L/usr/local/lib/lua/5.3/ \  -o example example.f90 libfortran-lua53.a -llua-5.3$ ./exampleHello from Lua!

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

$ gfortran -o example example.f90 libfortran-lua53.a /usr/local/lib/liblua-5.3.a

Additional examples can be found inexamples/.

• fibonacci: calls a recursive Lua routine loaded from file.
• library: calls a Fortran routine inside a shared library from Lua.
• string: runs Lua code stored in a Fortran string.
• table: reads values from a Lua table.

You can addfortran-lua53 as anfpmdependency:

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

The integer and float types used by Lua internally depend on the targetedplatform. The programtest/types.c outputs the types:

$ make test$ ./typeslua_integer.: c_long_longlua_number..: c_doublelua_kcontext: c_intptr_t

You may have to alterlua_integer,lua_number, andlua_kcontext insrc/lua.f90 accordingly.

ISC