Edit D:\app\Administrator\product\11.2.0\dbhome_1\perl\html\lib\ExtUtils\ParseXS.html
<?xml version="1.0" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ExtUtils::ParseXS - converts Perl XS code into C code</title> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <link rev="made" href="mailto:" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> ExtUtils::ParseXS - converts Perl XS code into C code</span></strong></big> </td></tr> </table> <!-- INDEX BEGIN --> <div name="index"> <p><a name="__index__"></a></p> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#export">EXPORT</a></li> <li><a href="#functions">FUNCTIONS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> <li><a href="#see_also">SEE ALSO</a></li> </ul> <hr name="index" /> </div> <!-- INDEX END --> <p> </p> <h1><a name="name">NAME</a></h1> <p>ExtUtils::ParseXS - converts Perl XS code into C code</p> <p> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <pre> use ExtUtils::ParseXS qw(process_file); process_file( filename => 'foo.xs' );</pre> <pre> process_file( filename => 'foo.xs', output => 'bar.c', 'C++' => 1, typemap => 'path/to/typemap', hiertype => 1, except => 1, prototypes => 1, versioncheck => 1, linenumbers => 1, optimize => 1, prototypes => 1, ); =head1 DESCRIPTION</pre> <p><code>ExtUtils::ParseXS</code> 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.</p> <p>The compiler will search for typemap files called <em>typemap</em>. It will use the following search path to find default typemaps, with the rightmost typemap taking precedence.</p> <pre> ../../../typemap:../../typemap:../typemap:typemap</pre> <p> </p> <hr /> <h1><a name="export">EXPORT</a></h1> <p>None by default. <code>process_file()</code> may be exported upon request.</p> <p> </p> <hr /> <h1><a name="functions">FUNCTIONS</a></h1> <dl> <dt><strong><a name="process_xs" class="item"><code>process_xs()</code></a></strong> <dd> <p>This function processes an XS file and sends output to a C file. Named parameters control how the processing is done. The following parameters are accepted:</p> </dd> <dl> <dt><strong><a name="c6" class="item"><strong>C++</strong></a></strong> <dd> <p>Adds <code>extern "C"</code> to the C code. Default is false.</p> </dd> </li> <dt><strong><a name="hiertype" class="item"><strong>hiertype</strong></a></strong> <dd> <p>Retains <code>::</code> in type names so that C++ hierachical types can be mapped. Default is false.</p> </dd> </li> <dt><strong><a name="except" class="item"><strong>except</strong></a></strong> <dd> <p>Adds exception handling stubs to the C code. Default is false.</p> </dd> </li> <dt><strong><a name="typemap" class="item"><strong>typemap</strong></a></strong> <dd> <p>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.</p> </dd> </li> <dt><strong><a name="prototypes" class="item"><strong>prototypes</strong></a></strong> <dd> <p>Generates prototype code for all xsubs. Default is false.</p> </dd> </li> <dt><strong><a name="versioncheck" class="item"><strong>versioncheck</strong></a></strong> <dd> <p>Makes sure at run time that the object file (derived from the <code>.xs</code> file) and the <code>.pm</code> files have the same version number. Default is true.</p> </dd> </li> <dt><strong><a name="linenumbers" class="item"><strong>linenumbers</strong></a></strong> <dd> <p>Adds <code>#line</code> directives to the C output so error messages will look like they came from the original XS file. Default is true.</p> </dd> </li> <dt><strong><a name="optimize" class="item"><strong>optimize</strong></a></strong> <dd> <p>Enables certain optimizations. The only optimization that is currently affected is the use of <em>target</em>s by the output C code (see <a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlguts.html">the perlguts manpage</a>). Not optimizing may significantly slow down the generated code, but this is the way <strong>xsubpp</strong> of 5.005 and earlier operated. Default is to optimize.</p> </dd> </li> <dt><strong><a name="inout" class="item"><strong>inout</strong></a></strong> <dd> <p>Enable recognition of <code>IN</code>, <code>OUT_LIST</code> and <code>INOUT_LIST</code> declarations. Default is true.</p> </dd> </li> <dt><strong><a name="argtypes" class="item"><strong>argtypes</strong></a></strong> <dd> <p>Enable recognition of ANSI-like descriptions of function signature. Default is true.</p> </dd> </li> <dt><strong><a name="s" class="item"><strong>s</strong></a></strong> <dd> <p>I have no clue what this does. Strips function prefixes?</p> </dd> </li> </dl> <dt><strong><a name="errors" class="item"><code>errors()</code></a></strong> <dd> <p>This function returns the number of [a certain kind of] errors encountered during processing of the XS file.</p> </dd> </li> </dl> <p> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>Based on xsubpp code, written by Larry Wall.</p> <p>Maintained by Ken Williams, <<a href="mailto:ken@mathforum.org">ken@mathforum.org</a>></p> <p> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>Copyright 2002-2003 Ken Williams. All rights reserved.</p> <p>This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p> <p>Based on the ExtUtils::xsubpp code by Larry Wall and the Perl 5 Porters, which was released under the same license terms.</p> <p> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <p><a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perl.html">the perl manpage</a>, ExtUtils::xsubpp, ExtUtils::MakeMaker, <a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlxs.html">the perlxs manpage</a>, <a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlxstut.html">the perlxstut manpage</a>.</p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> ExtUtils::ParseXS - converts Perl XS code into C code</span></strong></big> </td></tr> </table> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de