home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _6efc292868d69fc1f02a3ae9cf6aa3b4 < prev    next >
Text File  |  2000-03-23  |  5KB  |  141 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>IO::File - supply object methods for filehandles</TITLE>
  5. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> IO::File - supply object methods for filehandles</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#constructor">CONSTRUCTOR</A></LI>
  26.     <LI><A HREF="#methods">METHODS</A></LI>
  27.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  28.     <LI><A HREF="#history">HISTORY</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>IO::File - supply object methods for filehandles</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <PRE>
  47.     use IO::File;</PRE>
  48. <PRE>
  49.     $fh = new IO::File;
  50.     if ($fh->open("< file")) {
  51.         print <$fh>;
  52.         $fh->close;
  53.     }</PRE>
  54. <PRE>
  55.     $fh = new IO::File "> file";
  56.     if (defined $fh) {
  57.         print $fh "bar\n";
  58.         $fh->close;
  59.     }</PRE>
  60. <PRE>
  61.     $fh = new IO::File "file", "r";
  62.     if (defined $fh) {
  63.         print <$fh>;
  64.         undef $fh;       # automatically closes the file
  65.     }</PRE>
  66. <PRE>
  67.     $fh = new IO::File "file", O_WRONLY|O_APPEND;
  68.     if (defined $fh) {
  69.         print $fh "corge\n";</PRE>
  70. <PRE>
  71.         $pos = $fh->getpos;
  72.         $fh->setpos($pos);</PRE>
  73. <PRE>
  74.         undef $fh;       # automatically closes the file
  75.     }</PRE>
  76. <PRE>
  77.     autoflush STDOUT 1;</PRE>
  78. <P>
  79. <HR>
  80. <H1><A NAME="description">DESCRIPTION</A></H1>
  81. <P><CODE>IO::File</CODE> inherits from <CODE>IO::Handle</CODE> and <CODE>IO::Seekable</CODE>. It extends
  82. these classes with methods that are specific to file handles.</P>
  83. <P>
  84. <HR>
  85. <H1><A NAME="constructor">CONSTRUCTOR</A></H1>
  86. <DL>
  87. <DT><STRONG><A NAME="item_new">new ( FILENAME [,MODE [,PERMS]] )</A></STRONG><BR>
  88. <DD>
  89. Creates a <CODE>IO::File</CODE>.  If it receives any parameters, they are passed to
  90. the method <A HREF="#item_open"><CODE>open</CODE></A>; if the open fails, the object is destroyed.  Otherwise,
  91. it is returned to the caller.
  92. <P></P>
  93. <DT><STRONG><A NAME="item_new_tmpfile">new_tmpfile</A></STRONG><BR>
  94. <DD>
  95. Creates an <CODE>IO::File</CODE> opened for read/write on a newly created temporary
  96. file.  On systems where this is possible, the temporary file is anonymous
  97. (i.e. it is unlinked after creation, but held open).  If the temporary
  98. file cannot be created or opened, the <CODE>IO::File</CODE> object is destroyed.
  99. Otherwise, it is returned to the caller.
  100. <P></P></DL>
  101. <P>
  102. <HR>
  103. <H1><A NAME="methods">METHODS</A></H1>
  104. <DL>
  105. <DT><STRONG><A NAME="item_open">open( FILENAME [,MODE [,PERMS]] )</A></STRONG><BR>
  106. <DD>
  107. <A HREF="#item_open"><CODE>open</CODE></A> accepts one, two or three parameters.  With one parameter,
  108. it is just a front end for the built-in <A HREF="#item_open"><CODE>open</CODE></A> function.  With two or three
  109. parameters, the first parameter is a filename that may include
  110. whitespace or other special characters, and the second parameter is
  111. the open mode, optionally followed by a file permission value.
  112. <P>If <CODE>IO::File::open</CODE> receives a Perl mode string (``>'', ``+<'', etc.)
  113. or a ANSI C <CODE>fopen()</CODE> mode string (``w'', ``r+'', etc.), it uses the basic
  114. Perl <A HREF="#item_open"><CODE>open</CODE></A> operator (but protects any special characters).</P>
  115. <P>If <CODE>IO::File::open</CODE> is given a numeric mode, it passes that mode
  116. and the optional permissions value to the Perl <A HREF="../../lib/Pod/perlfunc.html#item_sysopen"><CODE>sysopen</CODE></A> operator.
  117. The permissions default to 0666.</P>
  118. <P>For convenience, <CODE>IO::File</CODE> exports the O_XXX constants from the
  119. Fcntl module, if this module is available.</P>
  120. <P></P></DL>
  121. <P>
  122. <HR>
  123. <H1><A NAME="see also">SEE ALSO</A></H1>
  124. <P><A HREF="../../lib/Pod/perlfunc.html">the perlfunc manpage</A>, 
  125. <A HREF="../../lib/Pod/perlop.html#i/o operators">I/O Operators in the perlop manpage</A>,
  126. <A HREF="../../lib/IO/Handle.html">the IO::Handle manpage</A>
  127. <A HREF="../../lib/IO/Seekable.html">the IO::Seekable manpage</A></P>
  128. <P>
  129. <HR>
  130. <H1><A NAME="history">HISTORY</A></H1>
  131. <P>Derived from FileHandle.pm by Graham Barr <<EM><A HREF="mailto:gbarr@pobox.com">gbarr@pobox.com</A></EM>>.</P>
  132. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  133. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  134. <STRONG><P CLASS=block> IO::File - supply object methods for filehandles</P></STRONG>
  135. </TD></TR>
  136. </TABLE>
  137.  
  138. </BODY>
  139.  
  140. </HTML>
  141.