DirHandle - supply object methods for directory handles
while (defined($_ = $d->read)) { something($_); }
while (defined($_ = $d->read)) { something_else($_); }
The C<DirHandle> method provide an alternative interface to the
opendir(), closedir(), readdir(), and rewinddir() functions.
The only objective benefit to using C<DirHandle> is that it avoids
namespace pollution by creating globs to hold directory handles.
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.
@_ >= 1 && @_ <= 2 or croak
'usage: new DirHandle [DIRNAME]';
DirHandle
::open($dh, $_[0])
@_ == 2 or croak
'usage: $dh->open(DIRNAME)';
@_ == 1 or croak
'usage: $dh->close()';
@_ == 1 or croak
'usage: $dh->read()';
@_ == 1 or croak
'usage: $dh->rewind()';