1ExtUtils::Typemaps::CmdU(s3e)r Contributed Perl DocumentaEtxitoUntils::Typemaps::Cmd(3)
2
3
4

NAME

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

SYNOPSIS

9       From XS:
10
11         INCLUDE_COMMAND: $^X -MExtUtils::Typemaps::Cmd \
12                          -e "print embeddable_typemap(q{Excommunicated})"
13
14       Loads "ExtUtils::Typemaps::Excommunicated", instantiates an object, and
15       dumps it as an embeddable typemap for use directly in your XS file.
16

DESCRIPTION

18       This is a helper module for ExtUtils::Typemaps for quick one-liners,
19       specifically for inclusion of shared typemaps that live on CPAN into an
20       XS file (see SYNOPSIS).
21
22       For this reason, the following functions are exported by default:
23

EXPORTED FUNCTIONS

25   embeddable_typemap
26       Given a list of identifiers, "embeddable_typemap" tries to load
27       typemaps from a file of the given name(s), or from a module that is an
28       "ExtUtils::Typemaps" subclass.
29
30       Returns a string representation of the merged typemaps that can be
31       included verbatim into XS. Example:
32
33         print embeddable_typemap(
34           "Excommunicated", "ExtUtils::Typemaps::Basic", "./typemap"
35         );
36
37       This will try to load a module "ExtUtils::Typemaps::Excommunicated" and
38       use it as an "ExtUtils::Typemaps" subclass. If that fails, it'll try
39       loading "Excommunicated" as a module, if that fails, it'll try to read
40       a file called Excommunicated. It'll work similarly for the second
41       argument, but the third will be loaded as a file first.
42
43       After loading all typemap files or modules, it will merge them in the
44       specified order and dump the result as an embeddable typemap.
45

SEE ALSO

47       ExtUtils::Typemaps
48
49       perlxs
50

AUTHOR

52       Steffen Mueller "<smueller@cpan.org">
53
55       Copyright 2012 Steffen Mueller
56
57       This program is free software; you can redistribute it and/or modify it
58       under the same terms as Perl itself.
59
60
61
62perl v5.36.0                      2023-01-20        ExtUtils::Typemaps::Cmd(3)
Impressum