SDL_EnumerateDirectoryCallback.3type - Man Page
Callback for directory enumeration.
Synopsis
#include <SDL3/SDL_filesystem.h> typedef SDL_EnumerationResult (SDLCALL *SDL_EnumerateDirectoryCallback)(void *userdata, const char *dirname, const char *fname);
Description
Enumeration of directory entries will continue until either all entries have been provided to the callback, or the callback has requested a stop through its return value.
Returning SDL_ENUM_CONTINUE will let enumeration proceed, calling the callback with further entries. SDL_ENUM_SUCCESS and SDL_ENUM_FAILURE will terminate the enumeration early, and dictate the return value of the enumeration function itself.
dirname is guaranteed to end with a path separator ('\\' on Windows, '/' on most other platforms).
Function Parameters
- userdata
an app-controlled pointer that is passed to the callback.
- dirname
the directory that is being enumerated.
- fname
the next entry in the enumeration.
Return Value
Returns how the enumeration should proceed.
Availability
This datatype is available since SDL 3.2.0.