=encoding utf8 =head1 NAME XS::Tutorial - documentation with examples for learning Perl XS =over 4 =item * L - how to pass to and return basic values from C functions =item * L - working with more than one value at a time =back =head1 SOURCES OF INFORMATION =head3 XS Mechanics by Steven W. McDougall A clear L to XS programming. =head3 Extending and Embedding Perl (Manning) by Simon Cozens and Tim Jenness A thorough L, with many examples. Outdated in parts (mostly data structures) but still an excellent reference. =head3 perldoc =over 4 =item * L: syntax of xsubs =item * L : C macros used to interact with Perl data structures (and the interpreter) =item * L: Perl data structures =item * L: typemap syntax (translating C types into Perl) =item * L: how to call Perl subroutines and methods from XS =item * L: another XS tutorial =back =head3 ExtUtils::MakeMaker The L explains all of the options in C. Useful if you need to pass additional flags or options to to the C compiler. =head3 ppport.h A header file, needed for compatibility across Perl versions. See L. =head3 Perl source code if you can’t find an answer in documentation, grep the L. =cut