Manual

Reference

Modules

  • A • B • C • D • E
  • F • G • H • I • L
  • M • N • O • P • S
  • T • U • X

Tools

readdir

Perl 5 version 12.1 documentation
Go to top
Show recent pages
Recently read

readdir

Perl functions A-Z | Perl functions by category | The 'perlfunc' manpage
  • readdir DIRHANDLE

    Returns the next directory entry for a directory opened by opendir. If used in list context, returns all the rest of the entries in the directory. If there are no more entries, returns the undefined value in scalar context and the empty list in list context.

    If you're planning to filetest the return values out of a readdir, you'd better prepend the directory in question. Otherwise, because we didn't chdir there, it would have been testing the wrong file.

    1.     opendir(my $dh, $some_dir) || die "can't opendir $some_dir: $!";
    2.     @dots = grep { /^\./ && -f "$some_dir/$_" } readdir($dh);
    3.     closedir $dh;

    As of Perl 5.11.2 you can use a bare readdir in a while loop, which will set $_ on every iteration.

    1.     opendir(my $dh, $some_dir) || die;
    2.     while(readdir $dh) {
    3.         print "$some_dir/$_\n";
    4.     }
    5.     closedir $dh;