dTHX;
PerlIO *f = NULL;
if (stdio) {
+ int mode = fcntl(fileno(stdio), F_GETFL);
PerlIOStdio *s =
PerlIOSelf(PerlIO_push
(aTHX_(f = PerlIO_allocate(aTHX)), &PerlIO_stdio,
- "r+", Nullsv), PerlIOStdio);
+ (mode&O_ACCMODE) == O_RDONLY ? "r"
+ : (mode&O_ACCMODE) == O_WRONLY ? "w"
+ : "r+",
+ Nullsv), PerlIOStdio);
s->stdio = stdio;
}
return f;
{
dTHX;
FILE *stdio;
+ char buf[8];
PerlIO_flush(f);
- stdio = fdopen(PerlIO_fileno(f), "r+");
+ stdio = fdopen(PerlIO_fileno(f), PerlIO_modestr(f,buf));
if (stdio) {
PerlIOStdio *s =
- PerlIOSelf(PerlIO_push(aTHX_ f, &PerlIO_stdio, "r+", Nullsv),
+ PerlIOSelf(PerlIO_push(aTHX_ f, &PerlIO_stdio, buf, Nullsv),
PerlIOStdio);
s->stdio = stdio;
}
=item B<PerlIO_exportFILE(f,flags)>
-Given a PerlIO * return a 'native' FILE * suitable for passing to code
+Given a PerlIO * create a 'native' FILE * suitable for passing to code
expecting to be compiled and linked with ANSI C I<stdio.h>.
The fact that such a FILE * has been 'exported' is recorded, and may
affect future PerlIO operations on the original PerlIO *.
+Calling this function repeatedly will create a FILE * on each call.
+
=item B<PerlIO_findFILE(f)>
-Returns previously 'exported' FILE * (if any). Placeholder until
-interface is fully defined.
+Returns a native FILE * used by a stdio layer. If there is none, it
+will create one with PerlIO_exportFILE.
=item B<PerlIO_releaseFILE(p,f)>
complete. It is removed from list of 'exported' FILE *s, and
associated PerlIO * should revert to original behaviour.
+(Currently a noop.)
+
=back
=head2 "Fast gets" Functions
piece is the order of that argument relative to the others (first, second,
etc). The second is the type of argument, and consists of the type
declaration of the argument (e.g., int, char*, etc). The third piece is
-the calling convention for the argument in the call to the library function.
+the calling convention for the argument in the call to the library function.
While Perl passes arguments to functions by reference,
C passes arguments by value; to implement a C function which modifies data
=head2 Installing your Extension
Once your extension is complete and passes all its tests, installing it
-is quite simple: you simply run "make install". You will either need
+is quite simple: you simply run "make install". You will either need
to have write permission into the directories where Perl is installed,
or ask your system administrator to run the make for you.
OUTPUT:
RETVAL
-And add the following code to test.pl, while incrementing the "1..11"
+And add the following code to test.pl, while incrementing the "1..11"
string in the BEGIN block to "1..13":
$results = Mytest::multi_statfs([ '/', '/blech' ]);
Setting $!
-=head2 EXAMPLE 9 (Coming Soon)
+=head2 EXAMPLE 9 Passing open files to XSes
+
+You would think passing files to an XS is difficult, with all the
+typeglobs and stuff. Well, it isn't.
+
+Suppose that for some strange reason we need a wrapper around the
+standard C library function C<fputs()>. This is all we need:
+
+ #define PERLIO_NOT_STDIO 0
+ #include "EXTERN.h"
+ #include "perl.h"
+ #include "XSUB.h"
+
+ #include <stdio.h>
+
+ int
+ fputs(s, stream)
+ char * s
+ FILE * stream
+
+The real work is done in the standard typemap.
+
+B<But> you loose all the fine stuff done by the perlio layers. This
+calls the stdio function C<fputs()>, which knows nothing about them.
+
+Now, suppose you want to use perlio layers in your XS. We'll use the
+perlio C<PerlIO_puts()> function as an example.
+
+For PerlIO *'s, we need a typemap because the standard typemap does
+not provide C<PerlIO *>:
+
+ PerlIO * T_INOUT
+
+And this is the XS code:
+
+ int
+ perlioputs(s, stream)
+ char * s
+ PerlIO * stream
+ CODE:
+ RETVAL = PerlIO_puts(stream, s);
+ OUTPUT:
+ RETVAL
+
+We have to use a C<CODE> section because C<PerlIO_puts()> has the arguments
+reversed compared to C<fputs()>, and we want to keep the arguments the same.
+
+Wanting to explore this thoroughly, we want to use the stdio C<fputs()>
+on an explicit PerlIO *. This means we have to ask the perlio system
+for a stdio C<FILE *>:
+
+ int
+ perliofputs(s, stream)
+ char * s
+ PerlIO * stream
+ PREINIT:
+ FILE *fp = PerlIO_findFILE(stream);
+ CODE:
+ if (fp != (FILE*) 0) {
+ RETVAL = fputs(s, fp);
+ } else {
+ RETVAL = -1;
+ }
+ OUTPUT:
+ RETVAL
+
+Note: C<PerlIO_findFILE()> will search the layers for a stdio
+layer. If it can't find one, it will call C<PerlIO_exportFILE()> to
+generate a new stdio C<FILE>. Please only call C<PerlIO_exportFILE()> if
+you want a I<new> C<FILE>. It will generate one on each call and push a
+new stdio layer. So don't call it repeatedly on the same
+file. C<PerlIO()>_findFILE will retrieve the stdio layer once it has been
+generated by C<PerlIO_exportFILE()>.
+
+This applies to the perlio system only. For versions before 5.7,
+C<PerlIO_exportFILE()> is equivalent to C<PerlIO_findFILE()>.
+
+
Getting fd's from filehandles
=item *
-This document assumes that the executable named "perl" is Perl version 5.
+This document assumes that the executable named "perl" is Perl version 5.
Some systems may have installed Perl version 5 as "perl5".
=back
Reviewed and assisted by Dean Roehrich, Ilya Zakharevich, Andreas Koenig,
and Tim Bunce.
+PerlIO material contributed by Lupe Christoph.
+
=head2 Last Changed
-1999/11/30
+2002/05/08