NAME

Module::Build::FFI - Build Perl extensions if C with FFI.

VERSION

version 0.07

SYNOPSIS

raw Build.PL:

use Module::Build::FFI 0.04;
Module::Build::FFI->new(
  module_name => 'Foo::Bar',
  ...
)->create_build_script;

Dist::Zilla:

[ModuleBuild]
mb_class      = Module::Build::FFI

[Prereqs / ConfigureRequires]
Module::Build::FFI = 0.03

Put your .c and .h files in ffi (ffi/example.c):

#include <ffi_util.h>
#include <stdio.h>

FFI_UTIL_EXPORT void print_hello(void)
{
  printf("hello world\n");
}

Attach it in your main module:

package Foo::Bar;

use FFI::Raw;
use FFI::Util qw( locate_module_share_lib );

my $lib = locate_module_share_lib();

*print_hello = FFI::Raw->new($lib, 'hello_world', FFI::Raw::void)->coderef; 

Use it elsewhere:

use Foo::Bar;
Foo::Bar::hello_world();

DESCRIPTION

Module::Build variant for writing Perl extensions in C with FFI.

MACROS

If you include the header file ffi_util.h you can use these macros. The header file was first included with version FFI::Util / Module::Build::FFI 0.04, so you should be sure to make that a prerequisite in either your Build.PL or dist.ini (or both).

FFI_UTIL_VERSION

This is the FFI::Util version number multiplied by 100 (so it should be 4 for 0.04 and 101 for 1.01).

FFI_UTIL_EXPORT

The appropriate attribute needed to export functions from shared libraries / DLLs. For now this is only necessary on Windows when using Microsoft Visual C++, but it may be necessary elsewhere in the future.

SEE ALSO

FFI::Util

FFI::Raw

Module::Build

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.