summaryrefslogtreecommitdiff
path: root/pod/perlapio.pod
diff options
context:
space:
mode:
authorNick Ing-Simmons <nik@tiuk.ti.com>2002-05-08 17:56:43 +0000
committerNick Ing-Simmons <nik@tiuk.ti.com>2002-05-08 17:56:43 +0000
commit79d3f390a594535ab6c3f423de0f87a0321f28d2 (patch)
tree4c0e1fd2b11ca232b972b6b1e7957708e011016c /pod/perlapio.pod
parentb31c3bce1c3a896d4e3b1b6f05853c476e891ae8 (diff)
downloadperl-79d3f390a594535ab6c3f423de0f87a0321f28d2.tar.gz
PerlIO/XS interface routine and doc updates from
lupe@lupe-christoph.de (Lupe Christoph) in mail Subject: [For Review] Patch for perlio.c and pods Message-Id: <20020505084315.GA23900@lupe-christoph.de> Date: Sun, 5 May 2002 10:43:15 +0200 (Minor tweaks to follow.) p4raw-id: //depot/perlio@16495
Diffstat (limited to 'pod/perlapio.pod')
-rw-r--r--pod/perlapio.pod10
1 files changed, 7 insertions, 3 deletions
diff --git a/pod/perlapio.pod b/pod/perlapio.pod
index 5103504565..22128db978 100644
--- a/pod/perlapio.pod
+++ b/pod/perlapio.pod
@@ -314,16 +314,18 @@ it a char *mode as in fopen/freopen.
=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)>
@@ -331,6 +333,8 @@ Calling PerlIO_releaseFILE informs PerlIO that all use of FILE * is
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