---
name: "FFI::Probe"
section: "3pm"
platform: "linux"
package: "libffi-platypus-perl"
version: "2.10-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/FFI::Probe"
---

# FFI::Probe(3pm)

System detection and probing for FFI extensions.

## NAME

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

## VERSION

version 2.10

## 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)

Lukas Mai (MAUKE)

## COPYRIGHT AND LICENSE

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