X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlembed.pod;h=57d1bdbc0efc5b59aa47ffecf1a55adfd72b9579;hb=3e2f796abf3f79e1ab191424e6c63f33a4ee4497;hp=dce785e6c294358995ee579bdbdfe3e0e03a7f15;hpb=72503137b2e9ea029110e27e896f6f1ccd8c0e8a;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlembed.pod b/pod/perlembed.pod index dce785e..57d1bdb 100644 --- a/pod/perlembed.pod +++ b/pod/perlembed.pod @@ -37,25 +37,45 @@ Read on... =over 5 -L +=item * -L +Compiling your C program -L +=item * -L +Adding a Perl interpreter to your C program -L +=item * -L +Calling a Perl subroutine from your C program -L +=item * -L +Evaluating a Perl statement from your C program -L +=item * -L +Performing Perl pattern matches and substitutions from your C program + +=item * + +Fiddling with the Perl stack from your C program + +=item * + +Maintaining a persistent interpreter + +=item * + +Maintaining multiple interpreter instances + +=item * + +Using Perl modules, which themselves use C libraries, from your C program + +=item * + +Embedding Perl under Win32 =back @@ -258,9 +278,8 @@ and package C blocks. If you want to pass arguments to the Perl subroutine, you can add strings to the C-terminated C list passed to I. For other data types, or to examine return values, -you'll need to manipulate the Perl stack. That's demonstrated in the -last section of this document: L. +you'll need to manipulate the Perl stack. That's demonstrated in +L. =head2 Evaluating a Perl statement from your C program @@ -356,7 +375,7 @@ made. int matches(SV *string, char *pattern, AV **matches); Given an C, a pattern, and a pointer to an empty C, -matches() evaluates C<$string =~ $pattern> in an array context, and +matches() evaluates C<$string =~ $pattern> in a list context, and fills in I with the array elements, returning the number of matches found. Here's a sample program, I, that uses all three (long lines have @@ -434,7 +453,7 @@ been wrapped here): /** matches(string, pattern, matches) ** - ** Used for matches in an array context. + ** Used for matches in a list context. ** ** Returns the number of matches, ** and fills in **matches with the matching substrings @@ -948,7 +967,7 @@ B can also automate writing the I glue code. Consult L, L, and L for more details. -=head1 Embedding Perl under Windows +=head1 Embedding Perl under Win32 In general, all of the source code shown here should work unmodified under Windows.