dirReturn an instance of the Directory class
&reftitle.description;
DirectoryDirectorystringpathresourcehandlestringDirectory::readvoidDirectory::rewindvoidDirectory::close
A pseudo-object oriented mechanism for reading a directory. The
given directory is opened. Two properties
are available once the directory has been opened. The handle
property can be used with other directory functions such as
readdir, rewinddir and
closedir. The path property is set to path
the directory that was opened. Three methods are available:
read, rewind and close.
&reftitle.examples;
dir example
Please note the fashion in which dir::read's
return value is checked in the example below. We are explicitly
testing whether the return value is identical to (equal to and of
the same type as - see
Comparison Operators for more information) &false; since
otherwise, any directory entry whose name evaluates to &false; will
stop the loop.
handle . "\n";
echo "Path: " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
echo $entry."\n";
}
$d->close();
?>
]]>
&example.outputs.similar;
&reftitle.notes;
The order in which directory entries are returned by the read method is
system-dependent.