manpagez: man pages & more
man ExtUtils::Typemaps::Cmd(3)
Home | html | info | man
ExtUtils::Typemaps::Cmd(3pm)                  Perl Programmers Reference Guide



NAME

       ExtUtils::Typemaps::Cmd - Quick commands for handling typemaps


SYNOPSIS

       From XS:

         INCLUDE_COMMAND: $^X -MExtUtils::Typemaps::Cmd \
                          -e "print embeddable_typemap(q{Excommunicated})"

       Loads "ExtUtils::Typemaps::Excommunicated", instantiates an object, and
       dumps it as an embeddable typemap for use directly in your XS file.


DESCRIPTION

       This is a helper module for ExtUtils::Typemaps for quick one-liners,
       specifically for inclusion of shared typemaps that live on CPAN into an
       XS file (see SYNOPSIS).

       For this reason, the following functions are exported by default:


EXPORTED FUNCTIONS

   embeddable_typemap
       Given a list of identifiers, "embeddable_typemap" tries to load
       typemaps from a file of the given name(s), or from a module that is an
       "ExtUtils::Typemaps" subclass.

       Returns a string representation of the merged typemaps that can be
       included verbatim into XS. Example:

         print embeddable_typemap(
           "Excommunicated", "ExtUtils::Typemaps::Basic", "./typemap"
         );

       This will try to load a module "ExtUtils::Typemaps::Excommunicated" and
       use it as an "ExtUtils::Typemaps" subclass. If that fails, it'll try
       loading "Excommunicated" as a module, if that fails, it'll try to read
       a file called Excommunicated. It'll work similarly for the second
       argument, but the third will be loaded as a file first.

       After loading all typemap files or modules, it will merge them in the
       specified order and dump the result as an embeddable typemap.


SEE ALSO

       ExtUtils::Typemaps(3)

       perlxs(1)


AUTHOR

       Steffen Mueller "<smueller@cpan.org">


COPYRIGHT & LICENSE

       Copyright 2012 Steffen Mueller

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

perl v5.38.2                      2023-11-28      ExtUtils::Typemaps::Cmd(3pm)

perl 5.38.2 - Generated Fri Dec 6 07:33:38 CST 2024
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.