logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

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

Availability

       This function is available since SDL 3.2.0.

Simple Directmedia Layer                           SDL 3.2.20                        SDL_GlobStorageDirectory(3)

Description

       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.

       If  path  is NULL, this is treated as a request to enumerate the root of the storage container's tree. An
       empty string also works for this.

Function Parameters

storage
              a storage container.

       path   the path of the directory to enumerate, or NULL for the root.

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

       flagsSDL_GLOB_* bitflags that affect this search.

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

Name

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

Return Value

       for more information. The caller should pass the returned pointer to SDL_free when done with it. This  is
       a single allocation that should be freed with SDL_free() when it is no longer needed.

Synopsis

#include<SDL3/SDL_storage.h>char**SDL_GlobStorageDirectory(SDL_Storage*storage,constchar*path,constchar*pattern,SDL_GlobFlagsflags,int*count);

Thread Safety

       It is safe to call this function from any thread, assuming the storage object is thread-safe.

See Also