Provides directory listing functions.
Well-defined value for an invalid directory stream handle.
A handle to an open directory stream.
typedef struct SbDirectoryPrivate* SbDirectory
Represents a directory entry.
char name
The name of this directory entry.
Indicates whether SbDirectoryOpen is allowed for the given path
.
path
: The path to be checked.
bool SbDirectoryCanOpen(const char *path)
Closes an open directory stream handle. The return value indicates whether the directory was closed successfully.
directory
: The directory stream handle to close.
bool SbDirectoryClose(SbDirectory directory)
Creates the directory path
, assuming the parent directory already exists. This function returns true
if the directory now exists (even if it existed before) and returns false
if the directory does not exist.
path
: The path to be created.
bool SbDirectoryCreate(const char *path)
Populates out_entry
with the next entry in the specified directory stream, and moves the stream forward by one entry.
This function returns true
if there was a next directory, and false
at the end of the directory stream.
directory
: The directory stream from which to retrieve the next directory. out_entry
: The variable to be populated with the next directory entry.
bool SbDirectoryGetNext(SbDirectory directory, SbDirectoryEntry *out_entry)
Returns whether the given directory stream handle is valid.
static bool SbDirectoryIsValid(SbDirectory directory)
Opens the given existing directory for listing. This function returns kSbDirectoryInvalidHandle if it is not successful.
If out_error
is provided by the caller, it will be set to the appropriate SbFileError code on failure.
out_error
: An output parameter that, in case of an error, is set to the reason that the directory could not be opened.
SbDirectory SbDirectoryOpen(const char *path, SbFileError *out_error)