SDL_EnumerateDirectoryCallback.3type - Man Page
Callback for directory enumeration.
Header File
Defined in SDL3/SDL_filesystem.h
Synopsis
#include "SDL3/SDL.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.