Function SDL_GetCurrentDirectory

pub unsafe extern "C" fn SDL_GetCurrentDirectory() -> *mut i8

Available on crate feature dep_sdl3 only.

Get what the system believes is the “current working directory.”

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.