# readdir

## Synopsis

```perl
my $entry = readdir($dh);      # scalar: one entry
my @entries = readdir($dh);     # list: all remaining entries
```

## Description

Reads entries from an open directory handle.

In **scalar context**, returns the next directory entry name as a
string, or `undef` when the directory is exhausted.  In **list
context**, returns all remaining entries as a list of strings.

Entry names are bare filenames (no path prefix).  The entries `.`
and `..` are included, matching perl5 behavior.

## See also

opendir, closedir, rewinddir, glob