(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_CreateEnvironment

Create a set of environment variables

Header File

Syntax

SDL_Environment * SDL_CreateEnvironment(bool populated);

Function Parameters

bool

populated

true to initialize it from the C runtime environment, false to create an empty environment.

Return Value

(SDL_Environment *) Returns a pointer to the new environment or NULL on failure; call SDL_GetError() for more information.

Thread Safety

If populated is false, it is safe to call this function from any thread, otherwise it is safe if no other threads are calling setenv() or unsetenv()

Version

This function is available since SDL 3.1.3.