oracular (3) ExtUtils::HasCompiler.3pm.gz

NAME

       ExtUtils::HasCompiler - Check for the presence of a compiler

VERSION

       version 0.025

SYNOPSIS

        use ExtUtils::HasCompiler 'can_compile_extension';
        if (can_compile_extension()) {
          ...
        }
        else {
          ...
        }

DESCRIPTION

       This module tries to check if the current system is capable of compiling, linking and loading an XS
       module.

       Notice: this is an early release, interface stability isn't guaranteed yet.

FUNCTIONS

   can_compile_loadable_object(%opts)
       This checks if the system can compile, link and load a perl loadable object. It may take the following
       options:

       •   quiet

           Do not output the executed compilation commands.

       •   config

           An ExtUtils::Config (compatible) object for configuration.

       •   skip_load

           This causes can_compile_loadable_object to not try to load the generated object. This defaults to
           true on a cross-compiling perl.

   can_compile_static_library(%opts)
       This checks if the system can compile and link a perl static library. It does not check it it can compile
       a new perl with it. It may take the following options:

       •   quiet

           Do not output the executed compilation commands.

       •   config

           An ExtUtils::Config (compatible) object for configuration.

   can_compile_extension(%opts)
       This will call either "can_compile_loadable_object", or "can_compile_static_library", depending on which
       is the default on your configuration. In addition to the arguments listed above, it can take one more
       optional argument:

       •   linktype

           This will force the linktype to be either static or dynamic. Dynamic compilation on a static perl
           won't work, but static libraries can be viable on a dynamic perl.

AUTHOR

       Leon Timmermans <fawaka@gmail.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2014 by Leon Timmermans.

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