home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _6b0dd13b86cf214665bd3626f1be9f99 < prev    next >
Text File  |  2000-03-23  |  5KB  |  127 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>IO-stringy - I/O on in-core objects like strings and arrays</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-stringy - I/O on in-core objects like strings and arrays</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="#installation">INSTALLATION</A></LI>
  26.     <LI><A HREF="#change log">CHANGE LOG</A></LI>
  27.     <LI><A HREF="#version">VERSION</A></LI>
  28.     <LI><A HREF="#author">AUTHOR</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>IO-stringy - I/O on in-core objects like strings and arrays</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.     IO::
  48.     ::AtomicFile   adpO  Write a file which is updated atomically     ERYQ
  49.     ::Lines        bdpO  I/O handle to read/write to array of lines   ERYQ
  50.     ::Scalar       RdpO  I/O handle to read/write to a string         ERYQ
  51.     ::ScalarArray  RdpO  I/O handle to read/write to array of scalars ERYQ
  52.     ::Wrap         RdpO  Wrap old-style FHs in standard OO interface  ERYQ
  53.     ::WrapTie      adpO  Tie your handles & retain full OO interface  ERYQ</PRE>
  54. <P>
  55. <HR>
  56. <H1><A NAME="description">DESCRIPTION</A></H1>
  57. <P>This toolkit primarily provides modules for performing both traditional 
  58. and object-oriented i/o) on things <EM>other</EM> than normal filehandles; 
  59. in particular, <A HREF="../../../site/lib/IO/Scalar.html">the IO::Scalar manpage</A>, <A HREF="../../../site/lib/IO/ScalarArray.html">the IO::ScalarArray manpage</A>, and <A HREF="../../../site/lib/IO/Lines.html">the IO::Lines manpage</A>.</P>
  60. <P>If you have access to tie(), these classes will make use of the
  61. <A HREF="../../../site/lib/IO/WrapTie.html">the IO::WrapTie manpage</A> module to inherit a convenient <CODE>new_tie()</CODE> constructor.
  62. It also exports a nice <CODE>wraptie()</CODE> function.</P>
  63. <P>In the more-traditional IO::Handle front, we have <A HREF="../../../site/lib/IO/AtomicFile.html">the IO::AtomicFile manpage</A>
  64. which may be used to painlessly create files which are updated
  65. atomically.</P>
  66. <P>And in the ``this-may-prove-useful'' corner, we have <A HREF="../../../site/lib/IO/Wrap.html">the IO::Wrap manpage</A>, whose
  67. exported <CODE>wraphandle()</CODE> function will clothe anything that's not
  68. a blessed object in an IO::Handle-like wrapper... so you can just
  69. use OO syntax and stop worrying about whether your function's caller
  70. handed you a string, a globref, or a FileHandle.</P>
  71. <P>
  72. <HR>
  73. <H1><A NAME="installation">INSTALLATION</A></H1>
  74. <P>You know the drill...</P>
  75. <PRE>
  76.     perl Makefile.PL
  77.     make test
  78.     make install</PRE>
  79. <P>
  80. <HR>
  81. <H1><A NAME="change log">CHANGE LOG</A></H1>
  82. <DL>
  83. <DT><STRONG><A NAME="item_Version_1%2E206">Version 1.206</A></STRONG><BR>
  84. <DD>
  85. Added creation of ./testout when Makefile.PL is run.
  86. <P></P>
  87. <DT><STRONG><A NAME="item_Version_1%2E205">Version 1.205</A></STRONG><BR>
  88. <DD>
  89. Verified for Perl5.005.
  90. <P></P>
  91. <DT><STRONG><A NAME="item_Version_1%2E202">Version 1.202</A></STRONG><BR>
  92. <DD>
  93. New IO::WrapTie and IO::AtomicFile added.
  94. <P></P>
  95. <DT><STRONG><A NAME="item_Version_1%2E110">Version 1.110</A></STRONG><BR>
  96. <DD>
  97. Added IO::WrapTie.
  98. <P></P>
  99. <DT><STRONG><A NAME="item_Version_1%2E107">Version 1.107</A></STRONG><BR>
  100. <DD>
  101. Added IO::Lines, and made some bug fixes to IO::ScalarArray. 
  102. Also, added getc().
  103. <P></P>
  104. <DT><STRONG><A NAME="item_Version_1%2E105">Version 1.105</A></STRONG><BR>
  105. <DD>
  106. No real changes; just upgraded IO::Wrap to have a $VERSION string.
  107. <P></P></DL>
  108. <P>
  109. <HR>
  110. <H1><A NAME="version">VERSION</A></H1>
  111. <P>$Id: Stringy.pm,v 1.207 1999/04/18 04:14:04 eryq Exp $</P>
  112. <P>
  113. <HR>
  114. <H1><A NAME="author">AUTHOR</A></H1>
  115. <P>Eryq (<EM><A HREF="mailto:eryq@zeegee.com">eryq@zeegee.com</A></EM>).
  116. President, ZeeGee Software Inc (<EM><A HREF="http://www.zeegee.com">http://www.zeegee.com</A></EM>).</P>
  117. <P>Enjoy.  Yell if it breaks.</P>
  118. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  119. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  120. <STRONG><P CLASS=block> IO-stringy - I/O on in-core objects like strings and arrays</P></STRONG>
  121. </TD></TR>
  122. </TABLE>
  123.  
  124. </BODY>
  125.  
  126. </HTML>
  127.