SDL_GetCurrentDirectory(3)

SDL_GetCurrentDirectory3

Get what the system believes is the "current working directory."

Usage

#include "SDL3/SDL.h"

char * SDL_GetCurrentDirectory(void);

Header file

Defined in SDL3/SDL_filesystem.h

Overview

For systems without a concept of a current working directory, this will still attempt to provide something reasonable.

SDL does not provide a means to _change_ the current working directory; for platforms without this concept, this would cause surprises with file access outside of SDL.

The returned path is guaranteed to end with a path separator ('\' on Windows, '/' on most other platforms).

Return value

Returns a UTF-8 string of the current working directory in platform-dependent notation. NULL if there's a problem. This should be freed with SDL_free () when it is no longer needed.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.