NAME

PerlIO::dir - Reads directories

SYNOPSIS

        open my $dirh, '<:dir', '.';
        binmode $dirh, ':encoding(cp932)'; # OK
        my @dirs = <$dirh>; # added "\n" at the end of the name
        chomp @dirs; # if necessary

DESCRIPTION

"PerlIO::dir" provides an interface to directory reading functions, opendir(), readdir(), "rewinddir" and closedir().

However, there is an important difference between ":dir" and Perl's readdir(). This layer appends a newline code, "\n", to the end of the name, because readline() requires input separators. Call chomp() if necessary.

You can use "seek($dirh, 0, 0)" for rewinddir().

SEE ALSO

"opendir" in perlfunc, "readdir" in perlfunc, "rewinddir" in perlfunc, "closedir" in perlfunc.

PerlIO::Util.

AUTHOR

Goro Fuji (藤 吾郎) <gfuji (at) cpan.org>

LICENSE AND COPYRIGHT

Copyright (c) 2008, Goro Fuji <gfuji (at) cpan.org>. Some rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.