Modern Fs ReadDir

Home › Filesystem › Filesystem Library › ReadDir

ReadDir

Lists the entries of one folder for a for each loop; each entry may be a failure to check.

Syntax

ReadDir( p )

Notes

• one level

Examples

#import "std/fs"
using fs

dim td as FsResultUStr = CreateTempDir( "fbdoc" )
dim as ustring dir_ = td.Value( )
WriteAllText( PathJoin( dir_, "a.txt" ), "aaa" )
WriteAllText( PathJoin( dir_, "b.txt" ), "bb" )
CreateDir( PathJoin( dir_, "sub" ) )
WriteAllText( PathJoin( dir_, "sub", "c.txt" ), "c" )

'' ONE LEVEL, lazily: entries come out as the directory is read, so a
'' huge directory does not have to be materialised first
dim as int32 n = 0
for each r in ReadDir( dir_ )
    if r.IsOk( ) then n += 1
next
print n                      '' 3 -- a.txt, b.txt, sub

'' Each element is a RESULT, because an entry can fail on its own -- a
'' file deleted mid-walk does not abandon the rest of the directory

RemoveDirAll( dir_ )

---

Library: Filesystem Library
Category: Filesystem
Documented under: Directories