This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

DirHandle(3pm)                        Perl Programmers Reference Guide                        DirHandle(3pm)



NAME
       DirHandle - supply object methods for directory handles

SYNOPSIS
           use DirHandle;
           $d = new DirHandle ".";
           if (defined $d) {
               while (defined($_ = $d->read)) { something($_); }
               $d->rewind;
               while (defined($_ = $d->read)) { something_else($_); }
               undef $d;
           }

DESCRIPTION
       The "DirHandle" method provide an alternative interface to the opendir(), closedir(), readdir(), and
       rewinddir() functions.

       The only objective benefit to using "DirHandle" is that it avoids namespace pollution by creating
       globs to hold directory handles.

NOTES
          On Mac OS (Classic), the path separator is ':', not '/', and the current directory is denoted as
           ':', not '.'. You should be careful about specifying relative pathnames. While a full path always
           begins with a volume name, a relative pathname should always begin with a ':'.  If specifying a
           volume name only, a trailing ':' is required.



perl v5.8.8                                      2001-09-21                                   DirHandle(3pm)