devela::_dep::sdl3::sys::filesystem

Function SDL_GlobDirectory

pub unsafe extern "C" fn SDL_GlobDirectory(
    path: *const i8,
    pattern: *const i8,
    flags: u32,
    count: *mut i32,
) -> *mut *mut i8
Available on crate feature dep_sdl3 only.
Expand description

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.

§Parameters

  • path: the path of the directory to enumerate.
  • pattern: the pattern that files in the directory must match. Can be NULL.
  • flags: SDL_GLOB_* bitflags that affect this search.
  • count: on return, will be set to the number of items in the returned array. Can be NULL.

§Return value

Returns 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.

§Thread safety

It is safe to call this function from any thread.

§Availability

This function is available since SDL 3.2.0.