NAME

FFI::Probe - System detection and probing for FFI extensions.

VERSION

version 1.56

SYNOPSIS

 use FFI::Probe;
 
 my $probe = FFI::Probe->new;
 $probe->check_header('foo.h');
 ...

DESCRIPTION

This class provides an interface for probing for system capabilities. It is used internally as part of the FFI::Platypus build process, but it may also be useful for extensions that use Platypus as well.

CONSTRUCTOR

new

 my $probe = FFI::Probe->new(%args);

Creates a new instance.

log: Path to a log or file handle to write to.
data_filename: Path to a file which will be used to store/cache results.

METHODS

check_header

 my $bool = $probe->check_header($header);

Checks that the given C header file is available. Stores the result, and returns a true/false value.

check_cpp

check_eval

 my $bool = $probe>check_eval(%args);

headers: Any additional headers.
decl: Any C declarations that need to be made before the "dlmain" function.
stmt: Any C statements that should be made before the evaluation.
eval: Any evaluations that should be returned.

check

check_type_int

 my $type = $probe->check_type_int($type);

check_type_enum

 my $type = $probe->check_type_enum;

check_type_enum

 my $type = $probe->check_type_enum;

check_type_float

 my $type = $probe->check_type_float($type);

check_type_pointer

 my $type = $probe->check_type_pointer;

set

 $probe->set(@key, $value);

Used internally to store a value.

save

 $probe->save;

Saves the values already detected.

data

 my $data = $probe->data;

Returns a hashref of the data already detected.

log

 $probe->log($string);

Sends the given string to the log.

log_code

 $prbe->log_code($string);

Sends the given multi-line code block to the log.

template

 my $template = $probe->template;

Returns the C code template used for "check_eval" and other "check_" methods.

AUTHOR

Author: Graham Ollis <plicease@cpan.org>

Contributors:

Bakkiaraj Murugesan (bakkiaraj)

Dylan Cali (calid)

pipcet

Zaki Mughal (zmughal)

Fitz Elliott (felliott)

Vickenty Fesunov (vyf)

Gregor Herrmann (gregoa)

Shlomi Fish (shlomif)

Damyan Ivanov

Ilya Pavlov (Ilya33)

Petr Písař (ppisar)

Mohammad S Anwar (MANWAR)

Håkon Hægland (hakonhagland, HAKONH)

Meredith (merrilymeredith, MHOWARD)

Diab Jerius (DJERIUS)

Eric Brine (IKEGAMI)

szTheory

José Joaquín Atria (JJATRIA)

Pete Houston (openstrike, HOUSTON)

COPYRIGHT AND LICENSE

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