ExamineDirectory()

Syntax

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

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

Parameter

#Verzeichnis	Eine Nummer, um die neue Verzeichnis-Auflistung zu identifizieren. #PB_Any kann als Parameter verwendet werden, um diese Nummer automatisch zu generieren.
VerzeichnisName$	Das zu untersuchende Verzeichnis.
Pattern$	Ein Pattern (Muster), 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$ = GetHomeDirectory() ; Listet alle Dateien und Ordner im 'Home'-Verzeichnis auf
  If ExamineDirectory(0, Directory$, "*.*")  
    While NextDirectoryEntry(0)
      If DirectoryEntryType(0) = #PB_DirectoryEntry_File
        Type$ = "[File] "
        Size$ = " (Size: " + DirectoryEntrySize(0) + ")"
      Else
        Type$ = "[Directory] "
        Size$ = "" ; A directory doesn't have a size
      EndIf
      
      Debug Type$ + DirectoryEntryName(0) + Size$
    Wend
    FinishDirectory(0)
  EndIf

Siehe auch

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

Unterstützte OS

Alle