Return a lazily populated Stream
, the elements of which are the entries in the directory. The listing is not recursive.
The elements of the stream are Path
objects that are obtained as if by resolving
the name of the directory entry against dir
. Some file systems maintain special links to the directory itself and the directory's parent directory. Entries representing these links are not included.
The stream is weakly consistent. It is thread safe but does not freeze the directory while iterating, so it may (or may not) reflect updates to the directory that occur after returning from this method.
The returned stream encapsulates a DirectoryStream
. If timely disposal of file system resources is required, the try
-with-resources construct should be used to ensure that the stream's close
method is invoked after the stream operations are completed.
Operating on a closed stream behaves as if the end of stream has been reached. Due to read-ahead, one or more elements may be returned after the stream has been closed.
try (Stream<Path> paths = Files.list(file.toPath())) {
paths.forEach(this::deleteFile);
}