unix-2.8.1.0: POSIX functionality

System.Posix.Directory.ByteString

Description

String-based POSIX directory support

Synopsis

# Creating and removing directories

createDirectory dir mode calls mkdir to create a new directory, dir, with permissions based on mode.

openDirStream dir calls opendir to obtain a directory stream for dir.

readDirStream dp calls readdir to obtain the next directory entry (struct dirent) for the open directory stream dp, and returns the d_name member of that structure.

Note that this function returns an empty filepath if the end of the directory stream is reached. For a safer alternative use readDirStreamMaybe.

readDirStreamMaybe dp calls readdir to obtain the next directory entry (struct dirent) for the open directory stream dp. It returns the d_name member of that structure wrapped in a Just d_name if an entry was read and Nothing if the end of the directory stream was reached.

rewindDirStream dp calls rewinddir to reposition the directory stream dp at the beginning of the directory.

closeDirStream dp calls closedir to close the directory stream dp.

# The working directory

getWorkingDirectory calls getcwd to obtain the name of the current working directory.

changeWorkingDirectory dir calls chdir to change the current working directory to dir.