Zugriff auf Verzeichnisse

Verzeichnis lesen

• 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. Wie üblich ist dies mit relativem (dir1/dir2/) oder absoluten (/name/dir/) Pfad möglich. Da es ein Verzeichnis ist, endet der Name zwingend mit einem Slash /.
• 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
  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 Quoting qr, 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 "dir/", "down,dir";

  Holt alle Verzeichnisse und Unterverzeichnisse im Verzeichnis dir.

  @dbs=get "dir/", "down,dir,db,join";

  Holt alle Verzeichnisse und Datenbanken im Verzeichnis dir und 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. Um ein volles Verzeichnis zu löschen, muss man ein "force" anhängen:

  del "dir/", "force";

  Löscht das Verzeichnis dir, egal ob es leer ist oder nicht. Entsprechend vorsichtig sollte man mit diesem Parameter umgehen - durch einen einzigen Befehl können Dutzende Datenbanken und Dateien auf einmal gelöscht werden!