Function SDL_GetEnvironment

pub unsafe extern "C" fn SDL_GetEnvironment() -> *mut SDL_Environment

Available on crate feature dep_sdl3 only.

Get the process environment.

This is initialized at application start and is not affected by setenv() and unsetenv() calls after that point. Use SDL_SetEnvironmentVariable() and SDL_UnsetEnvironmentVariable() if you want to modify this environment, or SDL_setenv_unsafe() or SDL_unsetenv_unsafe() if you want changes to persist in the C runtime environment after [SDL_Quit()].

Return value

Returns a pointer to the environment for the process or NULL on failure; call [SDL_GetError()] for more information.

Thread safety

It is safe to call this function from any thread.

Availability

This function is available since SDL 3.2.0.

See also

• SDL_GetEnvironmentVariable
• SDL_GetEnvironmentVariables
• SDL_SetEnvironmentVariable
• SDL_UnsetEnvironmentVariable