IO::Dir

IODir Dokumentation | Download als POD | Wie kann ich hier etwas ändern?

BEZEICHNUNG

IO::Dir - objektorientierter Zugriff auf Verzeichnishandles

ÜBERSICHT

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

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

BESCHREIBUNG

Das IO::Dir Package bietet zwei Schnittstellen zu den Verzeichnis-Leseroutinen Perls.

Die erste ist objektorientiert. IO::Dir bietet einen Konstruktor und Methoden, welche einfach die Verzeichnis-Leseroutinen Perls aufrufen.

new ( [ DIRNAME ] )

new ist der Konstruktor für IO::Dir -Objekte. Er akzeptiert ein optionales Argument welches, falls gegeben, new an open weitergibt.

Die folgenden Methoden sind Schnittstellen für die verzeichnisbezogenen Funktionen in Perl (das 'dir' am Ende wurde aus dem Namen entfernt). Siehe perlfunc für Details dieser Funktionen.

open ( DIRNAME )

read ()

seek ( POS )

tell ()

rewind ()

close ()

Außerdem bietet IO::Dir zum Lesen von Verzeichnissen eine Schnittstelle über einen gebundenen Hash (siehe Tie::Hash?). Der gebundene Hash erweitert die Schnittstelle über die Verzeichnis-Lesefunktionen hinaus, indem er lstat aus dem File::stat?-Package und die Funktionen perlfunc, unlink, perlfunc, rmdir und perlfunc, utime nutzt.

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

Die Schlüssel des Hashes enthalten die Namen der Verzeichniseinträge. Einen Wert des Hashes auszulesen kommt dem Aufruf von File::stat::lstat gleich. Das Löschen eines Wertes löscht auch die zugehörige Datei oder das zugehörige Verzeichnis, sofern DIR_UNLINK bei den OPTIONS von Perl angeben wurde.

Eine Zuweisung an einen Eintrag im Hash hat die Änderung des Timestamps zur Folge. Wenn die Datei nicht existiert, wird sie erstellt. Die Zuweisung eines einzelnen Integer-Wertes an ein Hash-Element bewirkt, dass die Zugriffs- und Änderungszeit auf diesen Wert gesetzt werden. Alternativ kann eine Referenz auf ein Array mit zwei Werten übergeben werden. Das erste Array-Element wird zum Setzen der Zugriffszeit benutzt und das zweite Element wird benutzt, um den Zeitpunkt der Änderung zu setzen.

SIEHE AUCH

File::stat?

AUTOR

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

ÜBERSETZUNG

Jan & pktm, auf perl-community.de zu finden.

COPYRIGHT

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.

Kommentare:

-- HaraldBongartz - 26 Apr 2005