ExamineDirectory()

Syntax

Ergebnis = ExamineDirectory(#Verzeichnis, VerzeichnisName$, Pattern$)

Beginnt die Untersuchung eines Verzeichnisses zur weiteren Auflistung mittels der Befehle NextDirectoryEntry(), DirectoryEntryName() und DirectoryEntryType().

Parameter

#Verzeichnis	Gibt eine Nummer an, um die neue Verzeichnis-Auflistung zu identifizieren. #PB_Any kann als Parameter verwendet werden, um diese Nummer automatisch zu generieren.
VerzeichnisName$	Gibt das zu untersuchende Verzeichnis an.
Pattern$	Gibt ein Pattern (Muster) an, nach dem die zurückgegebenen Einträge gefiltert werden. Zum Beispiel: Ein Pattern wie "*.*" oder "" wird alle Dateien (und Unter-Verzeichnisse) im Verzeichnis auflisten. Ein Pattern$ wie "*.exe" wird nur die .exe Dateien (und wenn vorhanden: Unterverzeichnisse, welche auf .exe enden) auflisten.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn das Verzeichnis untersucht werden kann, oder Null bei einem Fehler. Wenn #PB_Any als #Verzeichnis Parameter verwendet wurde, dann wird die generierte Verzeichnis-Nummer zurückgegeben.

Anmerkungen

Sobald die Untersuchung des Verzeichnisses abgeschlossen ist, muss FinishDirectory() aufgerufen werden, um die für das Auflisten benötigten Ressourcen freizugeben.

Beispiel

  Directory$ = "C:\"   ; Listet alle Einträge im Windows-Verzeichnis auf (ohne die Inhalte aus Unterverzeichnissen)
  If ExamineDirectory(0, Directory$, "*.*")  
    While NextDirectoryEntry(0)
      If DirectoryEntryType(0) = #PB_DirectoryEntry_File
        Type$ = " [File] "
      Else
        Type$ = " [Sub-Dir] "
      EndIf
      
      Debug DirectoryEntryName(0) + Type$ + "- Größe in Bytes: " + Str(DirectoryEntrySize(0))
    Wend
    FinishDirectory(0)
  EndIf

Siehe auch

FinishDirectory(), NextDirectoryEntry(), DirectoryEntryType(), DirectoryEntryName(), DirectoryEntrySize(), DirectoryEntryAttributes(), DirectoryEntryDate()

Unterstützte OS

Alle