mingw/html/lib/DirHandle.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>DirHandle - supply object methods for directory handles</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;DirHandle - supply object methods for directory handles</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#synopsis">SYNOPSIS</a></li>
  24         <li><a href="#description">DESCRIPTION</a></li>
  25         <li><a href="#notes">NOTES</a></li>
  26 </ul>
  27 <!-- INDEX END -->
  28
  29 <hr />
  30 <p>
  31 </p>
  32 <h1><a name="name">NAME</a></h1>
  33 <p>DirHandle - supply object methods for directory handles</p>
  34 <p>
  35 </p>
  36 <hr />
  37 <h1><a name="synopsis">SYNOPSIS</a></h1>
  38 <pre>
  39     use DirHandle;
  40     $d = new DirHandle &quot;.&quot;;
  41     if (defined $d) {
  42         while (defined($_ = $d-&gt;read)) { something($_); }
  43         $d-&gt;rewind;
  44         while (defined($_ = $d-&gt;read)) { something_else($_); }
  45         undef $d;
  46     }</pre>
  47 <p>
  48 </p>
  49 <hr />
  50 <h1><a name="description">DESCRIPTION</a></h1>
  51 <p>The <code>DirHandle</code> method provide an alternative interface to the
  52 opendir(), closedir(), readdir(), and <code>rewinddir()</code> functions.</p>
  53 <p>The only objective benefit to using <code>DirHandle</code> is that it avoids
  54 namespace pollution by creating globs to hold directory handles.</p>
  55 <p>
  56 </p>
  57 <hr />
  58 <h1><a name="notes">NOTES</a></h1>
  59 <ul>
  60 <li>
  61 <p>On Mac OS (Classic), the path separator is ':', not '/', and the
  62 current directory is denoted as ':', not '.'. You should be careful
  63 about specifying relative pathnames. While a full path always begins
  64 with a volume name, a relative pathname should always begin with a
  65 ':'.  If specifying a volume name only, a trailing ':' is required.</p>
  66 </li>
  67 </ul>
  68 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  69 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  70 <big><strong><span class="block">&nbsp;DirHandle - supply object methods for directory handles</span></strong></big>
  71 </td></tr>
  72 </table>
  73
  74 </body>
  75
  76 </html>