- baseportal Dokumentation

Titel:

<h2>Verzeichnis lesen</h2>

Definition:

<codeparse>
Ergebnisliste=get Verzeichnis[, Mode, [-]Filter, Entfernen, Ergebnishash];
</codeparse>

<ul type=square><li>In <c>Ergebnisliste</c> werden die ermittelten Einträge übergeben. Standardmässig werden die Verzeichnisse und Dateien getrennt voneinander alphabetisch sortiert. Beispiel:

<tab>
Name	Typ
aaa/	Verzeichnis
bbb/	Verzeichnis
ccc/	Verzeichnis
aaa.htx	Seite
bbb	Datenbank
bbb/ddd	Datenbank in Verzeichnis "bbb/"
ccc.htx	Seite
</tab>

<li><c>Verzeichnis</c> gibt das zu durchsuchende Verzeichnis an. Wie üblich ist dies mit relativem (<c>dir1/dir2/</c>) oder absoluten (<c>/name/dir/</c>) Pfad möglich. Da es ein Verzeichnis ist, endet der Name zwingend mit einem Slash <c>/</c>.

<li><c>Mode</c> kann folgende Werte annehmen:

<tab>
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
</tab>

Mehrere Werte können durch Komma <c>,</c> und/oder Leerzeichen getrennt angegeben werden, z.B.: <c>"down, base, db, htx"</c>.

<li> <c>Filter</c> ist eine regular expression die auf jeden Verzeichnis-Eintrag angewendet wird. Nur wenn diese zutrifft, wird der Eintrag in die <c>Ergebnisliste</c> aufgenommen. Ist das erste Zeichen von <c>Filter</c> ein Minuszeichen <c>-</c> so wird ein Eintrag nur aufgenommen, wenn der Filter nicht zutrifft. Benötigt man im <c>Filter</c> selbst zu Beginn ein Minuszeichen <c>-</c> so muss man dieses mit dem Backslash <c>\</c> maskieren.

<li> Auch bei <c>Entfernen</c> gibt man eine regular expression an, die -falls zutreffend- aus jedem Eintrag entfernt wird.

<achtung>
Will man beim Filter oder Entfernen den Backslash <c>\</c> übergeben, so kommt es zu Problemen, da die Maskierung bereits im Text aufgelöst wird. Übergibt man z.B. dem Filter <c>\.htx</c>, so wird der Backslash bereits im Text aufgelöst und nur <c>.htx</c> kommt bei der regular expression an. Zur Lösung bietet Perl das spezielle spezielle Quoting <c>qr</c>, das die regular expression so übergibt, wie sie ist (s.Beispiele).
</achtung>

Beispiele:

<code>
@dateien=get "dir/";
</code>

Holt alle Verzeichnisse, Datenbanken und Seiten im Verzeichnis <c>dir</c>.

<code>
@dateien=get "dir/", "file";
</code>

Holt alle Dateien (Datenbanken und Seiten) im Verzeichnis <c>dir</c>.

Holt alle Verzeichnisse und Unterverzeichnisse im Verzeichnis <c>dir</c>.

Holt alle Verzeichnisse und Datenbanken im Verzeichnis <c>dir</c> und allen Unterverzeichnissen und sortiert diese miteinander, so dass die Datenbanken in Unterverzeichnissen gleich nach diesen aufgelistet werden.

<code>
@backups=get "dir/", "down,db", qr/(^|\/)backup_/i;
</code>

Holt alle Datenbanken im Verzeichnis <c>dir</c> und allen Unterverzeichnissen, deren Name mit "backup_" (gross oder klein - wg. des angehängten "i") anfängt.

<code>
@seiten=get "dir/", "down,base,htx", qr/-\d+\.htx/, qr/\.htx$/;
</code>

Holt alle Seiten im Verzeichnis <c>dir</c> 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.

<h3>Verzeichnis anlegen</h3>

Legt das Verzeichnis <c>dir_neu</c> an. Ein gleichnamiges Verzeichnis darf nicht existieren.

<h3>Verzeichnis löschen</h3>

Löscht das Verzeichnis <c>dir</c>, 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:

<code>
del "dir/", "force";
</code>

Löscht das Verzeichnis <c>dir</c>, 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!

Name: Passwort: Stichworte: Version: 1 2 3 Angebot:

Ohne Änderungen zurück zur Seite

Neue Seite erstellen