ecl/examples/cmake

Description

This example shows how to setup CMake to build C++ project which uses ECL library.

In src/lisp is definition of core-lisp system that's being loaded into C++ program.

Functions defined in src/lisp/core-lisp.lisp:

(defun hello-world () (format t "Hello World!~%"))

are used in src/cxx/main.cpp:

extern "C" {
  extern void init_lib_CORE_LISP(cl_object);
}

int main(int argc, char** argv) {
  cl_boot(argc, argv);
  ecl_init_module(NULL, init_lib_CORE_LISP);
  cl_eval(c_string_to_object("(hello-world)"));
  cl_shutdown();
  return 0;
}

CMakeLists.txt

For more information about setup read CMakeLists.txt comments.

Build

Run:

$ mkdir build
$ cd build

If ECL is built and installed with non-default prefix use:

$ cmake -DCMAKE_PREFIX_PATH=/home/user/local_prefix/ ..

Otherwise you don't have to set CMAKE_PREFIX_PATH:

$ cmake ..

Finally run:

$ make

It shall produce: cmake_ecl executable and core-lisp.a static library that has been linked to executable.

Run

$ ./cmake_ecl
Hello World!

Notes

1. You don't have to remove ./build directory if you want to change option in CMakeLists.txt. Just run make.

2. If you see undefined reference errors look at nm --demangle core-lisp.a output. You may have forgot setting :init-name in CMakeLists.txt

3. To reuse this example you must copy cmake directory to your project. It contains FindECL.cmake

4. You don't have to have ecl executable in $PATH environment variable. FindECL.cmake shall find it.