Perl XS

Web links

• perlxs - XS language reference manual

  The "official" XS documentation. I find it difficult to read, especially the top part.

• perlapi - autogenerated documentation for the perl public API

  This link is to the website perldoc.perl.org, because for some reason the version of this document on CPAN has not been processed correctly.

• perlXStut - Tutorial for writing XSUBs

  This is part of the "official" Perl documentation. Like "perlxs", I find it very difficult to read. The document tends to veer off into discussions of things which aren't really relevant, which makes it very hard for a beginner to follow, since the poor beginner doesn't know what is important.

• Perl XS tutorial - digest version

  This is a digest of perlxstut, on this website. The goal of this digest is to remove all the distractions so that the document is simply a tutorial on XS, rather than a discussion of Perl programming in general.

• perlguts - Introduction to the Perl API

  This is the main document to refer to for programming a C extension to Perl.

• Extending and Embedding Perl by Tim Jenness and Simon Cozens

  Home page for a book on using XS.

• Perl source code (version 5.14.1)
• Pitfals of the Perl XS or what to do when things do not work as advertised

  Many complaints about h2xs. I too have found h2xs to be difficult to use, and this article gives some more detailed insights.

• Converting C arrays to Perl lists

  How to convert C array into a Perl array. More generally, an example of how to use PPCODE to manipulate the Perl stack.