Gecko [ theprintave.ca ]

Name	Size	Permission	Date
CBuilder	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
Command	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
Constant	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
Liblist	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
MakeMaker	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
ParseXS	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
Typemaps	[ DIR ]	drwxr-xr-x	2025-04-15 06:10
CBuilder.pm	8.67 KB	-rw-r--r--	2025-04-08 13:21
Command.pm	7.63 KB	-rw-r--r--	2025-04-08 13:21
Constant.pm	14.7 KB	-rw-r--r--	2025-04-08 13:21
Embed.pm	12.57 KB	-rw-r--r--	2025-04-08 13:21
Install.pm	39.92 KB	-rw-r--r--	2025-04-08 13:21
Installed.pm	14 KB	-rw-r--r--	2025-04-08 13:21
Liblist.pm	9.29 KB	-rw-r--r--	2025-04-08 13:21
MANIFEST.SKIP	1.17 KB	-rw-r--r--	2025-04-08 13:21
MM.pm	2.13 KB	-rw-r--r--	2025-04-08 13:21
MM_AIX.pm	1.46 KB	-rw-r--r--	2025-04-08 13:21
MM_Any.pm	80.97 KB	-rw-r--r--	2025-04-08 13:21
MM_BeOS.pm	1.04 KB	-rw-r--r--	2025-04-08 13:21
MM_Cygwin.pm	4.03 KB	-rw-r--r--	2025-04-08 13:21
MM_DOS.pm	1.04 KB	-rw-r--r--	2025-04-08 13:21
MM_Darwin.pm	1.45 KB	-rw-r--r--	2025-04-08 13:21
MM_MacOS.pm	901 B	-rw-r--r--	2025-04-08 13:21
MM_NW5.pm	5.35 KB	-rw-r--r--	2025-04-08 13:21
MM_OS2.pm	3.15 KB	-rw-r--r--	2025-04-08 13:21
MM_OS390.pm	2.22 KB	-rw-r--r--	2025-04-08 13:21
MM_QNX.pm	907 B	-rw-r--r--	2025-04-08 13:21
MM_UWIN.pm	994 B	-rw-r--r--	2025-04-08 13:21
MM_Unix.pm	111.19 KB	-rw-r--r--	2025-04-08 13:21
MM_VMS.pm	66.68 KB	-rw-r--r--	2025-04-08 13:21
MM_VOS.pm	762 B	-rw-r--r--	2025-04-08 13:21
MM_Win32.pm	14.71 KB	-rw-r--r--	2025-04-08 13:21
MM_Win95.pm	1.26 KB	-rw-r--r--	2025-04-08 13:21
MY.pm	676 B	-rw-r--r--	2025-04-08 13:21
MakeMaker.pm	106.93 KB	-rw-r--r--	2025-04-08 13:21
Manifest.pm	22.94 KB	-rw-r--r--	2025-04-08 13:21
Miniperl.pm	6.48 KB	-rw-r--r--	2025-04-08 13:21
Mkbootstrap.pm	3.2 KB	-rw-r--r--	2025-04-08 13:21
Mksymlists.pm	10.75 KB	-rw-r--r--	2025-04-08 13:21
PL2Bat.pm	5.1 KB	-rw-r--r--	2025-04-08 13:21
Packlist.pm	8.34 KB	-rw-r--r--	2025-04-08 13:21
ParseXS.pm	65.36 KB	-rw-r--r--	2025-04-08 13:21
ParseXS.pod	4.3 KB	-rw-r--r--	2025-04-08 13:21
Typemaps.pm	26.26 KB	-rw-r--r--	2025-04-08 13:21
testlib.pm	911 B	-rw-r--r--	2025-04-08 13:21
typemap	11.05 KB	-rw-r--r--	2025-04-08 13:21
xsubpp	4.95 KB	-rw-r--r--	2025-04-08 13:21

Rename

=head1 NAME

ExtUtils::ParseXS - converts Perl XS code into C code

=head1 SYNOPSIS

use ExtUtils::ParseXS;

my $pxs = ExtUtils::ParseXS->new;
  $pxs->process_file( filename => 'foo.xs' );

$pxs->process_file( filename => 'foo.xs',
                      output => 'bar.c',
                      'C++' => 1,
                      typemap => 'path/to/typemap',
                      hiertype => 1,
                      except => 1,
                      versioncheck => 1,
                      linenumbers => 1,
                      optimize => 1,
                      prototypes => 1,
                    );

# Legacy non-OO interface using a singleton:
  use ExtUtils::ParseXS qw(process_file);
  process_file( filename => 'foo.xs' );

=head1 DESCRIPTION

C<ExtUtils::ParseXS> will compile XS code into C code by embedding the constructs
necessary to let C functions manipulate Perl values and creates the glue
necessary to let Perl access those functions.  The compiler uses typemaps to
determine how to map C function parameters and variables to Perl values.

The compiler will search for typemap files called I<typemap>.  It will use
the following search path to find default typemaps, with the rightmost
typemap taking precedence.

../../../typemap:../../typemap:../typemap:typemap

=head1 EXPORT

None by default.  C<process_file()> and/or C<report_error_count()>
may be exported upon request. Using the functional interface is
discouraged.

=head1 METHODS

=over 4

=item $pxs->new()

Returns a new, empty XS parser/compiler object.

=item $pxs->process_file()

This method processes an XS file and sends output to a C file.
The method may be called as a function (this is the legacy
interface) and will then use a singleton as invocant.

Named parameters control how the processing is done.
The following parameters are accepted:

=over 4

=item B<C++>

Adds C<extern "C"> to the C code.  Default is false.

=item B<hiertype>

Retains C<::> in type names so that C++ hierarchical types can be
mapped.  Default is false.

=item B<except>

Adds exception handling stubs to the C code.  Default is false.

=item B<typemap>

Indicates that a user-supplied typemap should take precedence over the
default typemaps.  A single typemap may be specified as a string, or
multiple typemaps can be specified in an array reference, with the
last typemap having the highest precedence.

=item B<prototypes>

Generates prototype code for all xsubs.  Default is false.

=item B<versioncheck>

Makes sure at run time that the object file (derived from the C<.xs>
file) and the C<.pm> files have the same version number.  Default is
true.

=item B<linenumbers>

Adds C<#line> directives to the C output so error messages will look
like they came from the original XS file.  Default is true.

=item B<optimize>

Enables certain optimizations.  The only optimization that is currently
affected is the use of I<target>s by the output C code (see L<perlguts>).
Not optimizing may significantly slow down the generated code, but this is the way
B<xsubpp> of 5.005 and earlier operated.  Default is to optimize.

=item B<inout>

Enable recognition of C<IN>, C<OUT_LIST> and C<INOUT_LIST>
declarations.  Default is true.

=item B<argtypes>

Enable recognition of ANSI-like descriptions of function signature.
Default is true.

=item B<s>

I<Maintainer note:> I have no clue what this does.  Strips function prefixes?

=back

=item $pxs->report_error_count()

This method returns the number of [a certain kind of] errors
encountered during processing of the XS file.

The method may be called as a function (this is the legacy
interface) and will then use a singleton as invocant.

=back

=head1 AUTHOR

Based on xsubpp code, written by Larry Wall.

Maintained by:

=over 4

=item *

Ken Williams, <ken@mathforum.org>

=item *

David Golden, <dagolden@cpan.org>

=item *

James Keenan, <jkeenan@cpan.org>

=item *

Steffen Mueller, <smueller@cpan.org>

=back

=head1 COPYRIGHT

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

Based on the C<ExtUtils::xsubpp> code by Larry Wall and the Perl 5
Porters, which was released under the same license terms.

=head1 SEE ALSO

L<perl>, ExtUtils::xsubpp, ExtUtils::MakeMaker, L<perlxs>, L<perlxstut>.

=cut