(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable 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.0.0.