MirBSD manpage: IO::Dir(3p)

IO::Dir(3p)     Perl Programmers Reference Guide      IO::Dir(3p)


     IO::Dir - supply object methods for directory handles


         use IO::Dir;
         $d = IO::Dir->new(".");
         if (defined $d) {
             while (defined($_ = $d->read)) { something($_); }
             while (defined($_ = $d->read)) { something_else($_); }
             undef $d;

         tie %dir, 'IO::Dir', ".";
         foreach (keys %dir) {
             print $_, " " , $dir{$_}->size,"\n";


     The "IO::Dir" package provides two interfaces to perl's
     directory reading routines.

     The first interface is an object approach. "IO::Dir" pro-
     vides an object constructor and methods, which are just
     wrappers around perl's built in directory reading routines.

     new ( [ DIRNAME ] )
         "new" is the constructor for "IO::Dir" objects. It
         accepts one optional argument which,  if given, "new"
         will pass to "open"

     The following methods are wrappers for the directory related
     functions built into perl (the trailing `dir' has been
     removed from the names). See perlfunc for details of these

     open ( DIRNAME )
     read ()
     seek ( POS )
     tell ()
     rewind ()
     close ()

     "IO::Dir" also provides an interface to reading directories
     via a tied hash. The tied hash extends the interface beyond
     just the directory reading routines by the use of "lstat",
     from the "File::stat" package, "unlink", "rmdir" and

     tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]

perl v5.8.8                2005-02-05                           1

IO::Dir(3p)     Perl Programmers Reference Guide      IO::Dir(3p)

     The keys of the hash will be the names of the entries in the
     directory. Reading a value from the hash will be the result
     of calling "File::stat::lstat".  Deleting an element from
     the hash will delete the corresponding file or subdirectory,
     provided that "DIR_UNLINK" is included in the "OPTIONS".

     Assigning to an entry in the hash will cause the time stamps
     of the file to be modified. If the file does not exist then
     it will be created. Assigning a single integer to a hash
     element will cause both the access and modification times to
     be changed to that value. Alternatively a reference to an
     array of two values can be passed. The first array element
     will be used to set the access time and the second element
     will be used to set the modification time.




     Graham Barr. Currently maintained by the Perl Porters.
     Please report all bugs to <perl5-porters@perl.org>.


     Copyright (c) 1997-2003 Graham Barr <gbarr@pobox.com>. All
     rights reserved. This program is free software; you can
     redistribute it and/or modify it under the same terms as
     Perl itself.

perl v5.8.8                2005-02-05                           2

Generated on 2022-12-24 01:00:14 by $MirOS: src/scripts/roff2htm,v 1.113 2022/12/21 23:14:31 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2022 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.

Kontakt / Impressum & Datenschutzerklärung