++ed by:
KES KEEDI ASHLEYW POTATOGIM
Author image 🦖🦜Graham Ollis🦃🦕
and 5 contributors

NAME

FFI::Library - Perl Access to Dynamically Loaded Libraries

VERSION

version 1.15

SYNOPSIS

 # call function from arbitrary dynamic library
 use FFI::Library;
 $lib = FFI::Library->new("mylib");
 $fn = $lib->function("fn", "signature");
 $ret = $fn->(...);

 # call function from libc
 $clib_file = ($^O eq "MSWin32") ? "MSVCRT40.DLL" : "-lc";
 $clib = FFI::Library->new($clib_file);
 $strlen = $clib->function("strlen", "cIp");
 $n = $strlen->($my_string);

DESCRIPTION

NOTE: Newer and better maintained FFI modules such as FFI::Platypus provide more functionality and so it is strongly recommend that you use one of them for new projects and even consider migrating to one of them for existing projects.

This module provides access from Perl to functions exported from dynamically linked libraries. Functions are described by signatures, for details of which see the FFI module's documentation.

CONSTRUCTOR

new

 my $lib = FFI::Library->new($libname);

Creates an instance of FFI::Library.

FUNCTIONS

address

 my $address = $lib->address($function_name);

Returns the symbol of the given function. Returns undef if the symbol is not found.

function

 my $sub = $lib->function($function_name, $signature);

Creates a code-reference like object which you can call.

EXAMPLES

 $clib_file = ($^O eq "MSWin32") ? "MSVCRT40.DLL" : "-lc";
 $clib = FFI::Library->new($clib_file);
 $strlen = $clib->function("strlen", "cIp");
 $n = $strlen->($my_string);

SUPPORT

Please open any support tickets with this project's GitHub repository here:

https://github.com/Perl5-FFI/FFI/issues

SEE ALSO

FFI

Low level interface to ffcall that this module is based on

FFI::CheckLib

Portable functions for finding libraries.

FFI::Platypus

Platypus is another FFI interface based on libffi. It has a more extensive feature set, and libffi has a less restrictive license.

AUTHOR

Original author: Paul Moore <gustav@morpheus.demon.co.uk>

Current maintainer: Graham Ollis <plicease@cpan.org>

Contributors:

Anatoly Vorobey <avorobey@pobox.com>

Gaal Yahas <gaal@forum2.org>

Mitchell Charity <mcharity@vendian.org>

Reini Urban <<RURBAN@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016-2018 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.