Verzeichnis lesen
Definition:
- In Ergebnisliste werden die ermittelten Einträge übergeben. Standardmässig werden die Verzeichnisse und Dateien getrennt voneinander alphabetisch sortiert. Beispiel:
Name Typ aaa/ Verzeichnis bbb/ Verzeichnis ccc/ Verzeichnis aaa.htx Seite bbb Datenbank bbb/ddd Datenbank in Verzeichnis "bbb/" ccc.htx Seite - Verzeichnis gibt das zu durchsuchende Verzeichnis an und muss mit einem Slash / enden. Folgende Angaben sind möglich:
Wert Bedeutung / Hauptverzeichnis des Nutzers ./ Aktuelles Verzeichnis in dem die ausgeführte Seite liegt ../ Ein Verzeichnis höher (auch verschachtelt möglich, also "../../" oder "../verzeichnis/" etc.) verzeichnis/ Verzeichnis innerhalb des Verzeichnisses in dem die ausgeführte Seite liegt (=relativ) /name/verzeichnis/ Verzeichnis im Hauptverzeichnis des Nutzers "name" (=absolut) - Mode kann folgende Werte annehmen:
Name Bedeutung down Verzeichnis wird rekursiv, d.h. mit allen Unterverzeichnissen (und deren Unterverzeichnissen etc.), durchlaufen base Der Grundpfad des Verzeichnisses wird allen Einträgen vorangestellt (=absolut) name Es wird nur der Name des Eintrags, ohne den jeweiligen Pfad, aufgenommen cut Entfernt alle Endungen, also .htx oder / join Sortiert Verzeichnisse und Dateien zusammen dir (Nur) Verzeichnisse werden in die Ergebnisliste aufgenommen file (Nur) Dateien (Datenbanken und Seiten) werden in die Ergebnisliste aufgenommen db (Nur) Datenbanken werden in die Ergebnisliste aufgenommen htx (Nur) Seiten werden in die Ergebnisliste aufgenommen Mehrere Werte können durch Komma , und/oder Leerzeichen getrennt angegeben werden, z.B.: "down, base, db, htx".
- Filter ist eine regular expression die auf jeden Verzeichnis-Eintrag angewendet wird. Nur wenn diese zutrifft, wird der Eintrag in die Ergebnisliste aufgenommen. Ist das erste Zeichen von Filter ein Minuszeichen - so wird ein Eintrag nur aufgenommen, wenn der Filter nicht zutrifft. Benötigt man im Filter selbst zu Beginn ein Minuszeichen - so muss man dieses mit dem Backslash \ maskieren.
- Auch bei Entfernen gibt man eine regular expression an, die -falls zutreffend- aus jedem Eintrag entfernt wird.
Beachten Sie Will man beim Filter oder Entfernen den Backslash \ übergeben, so kommt es zu Problemen, da die Maskierung bereits im Text aufgelöst wird. Übergibt man z.B. dem Filter\.htx , so wird der Backslash bereits im Text aufgelöst und nur.htx kommt bei der regular expression an. Zur Lösung bietet Perl das spezielle spezielle Quotingqr , das die regular expression so übergibt, wie sie ist (s.Beispiele).Beispiele:
@dateien=get "dir/";
Holt alle Verzeichnisse, Datenbanken und Seiten im Verzeichnis dir.
@dateien=get "dir/", "file";
Holt alle Dateien (Datenbanken und Seiten) im Verzeichnis dir.
@dirs=get "/", "down,dir";
Holt alle Verzeichnisse und Unterverzeichnisse im Hauptverzeichnis des Nutzers.
@dbs=get "./", "down,dir,db,join";
Holt alle Verzeichnisse und Datenbanken im Verzeichnis in dem die aufgerufene Seite liegt, sowie allen Unterverzeichnissen und sortiert diese miteinander, so dass die Datenbanken in Unterverzeichnissen gleich nach diesen aufgelistet werden.
@backups=get "dir/", "down,db", qr/(^|\/)backup_/i;
Holt alle Datenbanken im Verzeichnis dir und allen Unterverzeichnissen, deren Name mit "backup_" (gross oder klein - wg. des angehängten "i") anfängt.
@seiten=get "dir/", "down,base,htx", qr/-\d+\.htx/, qr/\.htx$/;
Holt alle Seiten im Verzeichnis dir und allen Unterverzeichnissen, die nicht mit einer Zahl enden (z.B. "text123.htx" wird nicht geholt). Allen anderen Seiten wird der Basispfad vorangestellt und das ".htx" am Ende abgeschnitten.
Verzeichnis anlegen
put "dir_neu/";
Legt das Verzeichnis dir_neu an. Ein gleichnamiges Verzeichnis darf nicht existieren.
Verzeichnis löschen
del "dir/";
Löscht das Verzeichnis dir, allerdings nur, wenn es komplett leer ist, also wenn keine Dateien oder Verzeichnisse darin enthalten sind.