DirHandle

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



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 care-
	   ful 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(3)