osx man page for dirhandle

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

NAME
       DirHandle - supply object methods for directory handles

SYNOPSIS
	   use DirHandle;
	   $d = DirHandle->new(".");
	   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.

perl v5.16.2							    2012-10-11							    DirHandle(3pm)