SDL_GlobDirectory

Enumerate a directory tree, filtered by pattern, and return a list.

Files are filtered out if they don't match the string in pattern, which may contain wildcard characters '\*' (match everything) and '?' (match one character). If pattern is NULL, no filtering is done and all results are returned. Subdirectories are permitted, and are specified with a path separator of '/'. Wildcard characters '\*' and '?' never match a path separator.

flags may be set to SDL_GLOB_CASEINSENSITIVE to make the pattern matching case-insensitive.

The returned array is always NULL-terminated, for your iterating convenience, but if count is non-NULL, on return it will contain the number of items in the array, not counting the NULL terminator.

extern (C) nothrow @nogc extern
char**
SDL_GlobDirectory
(
const(char)* path
,
const(char)* pattern
,,
int* count
)

Parameters

path const(char)*

the path of the directory to enumerate.

pattern const(char)*

the pattern that files in the directory must match. Can be NULL.

flags SDL_GlobFlags

SDL_GLOB_* bitflags that affect this search.

count int*

on return, will be set to the number of items in the returned array. Can be NULL.

Return Value

Type: char**

an array of strings on success or NULL on failure; call SDL_GetError() for more information. This is a single allocation that should be freed with SDL_free() when it is no longer needed.

Threadsafety: It is safe to call this function from any thread.

Meta