|
@@ -1776,6 +1776,12 @@ typedef struct SDL_Environment SDL_Environment;
|
|
|
* SDL_setenv_unsafe() or SDL_unsetenv_unsafe() if you want changes to persist
|
|
* SDL_setenv_unsafe() or SDL_unsetenv_unsafe() if you want changes to persist
|
|
|
* in the C runtime environment after SDL_Quit().
|
|
* in the C runtime environment after SDL_Quit().
|
|
|
*
|
|
*
|
|
|
|
|
+ * Note that on Windows, the variable names pulled in from the system at
|
|
|
|
|
+ * startup have their ASCII values uppercased, to match what most platforms
|
|
|
|
|
+ * expect even though the Windows system environment table is
|
|
|
|
|
+ * case-insensitive. Once those uppercased variable names are in an
|
|
|
|
|
+ * SDL_Environment, SDL treats them as case-sensitive.
|
|
|
|
|
+ *
|
|
|
* \returns a pointer to the environment for the process or NULL on failure;
|
|
* \returns a pointer to the environment for the process or NULL on failure;
|
|
|
* call SDL_GetError() for more information.
|
|
* call SDL_GetError() for more information.
|
|
|
*
|
|
*
|
|
@@ -1791,7 +1797,13 @@ typedef struct SDL_Environment SDL_Environment;
|
|
|
extern SDL_DECLSPEC SDL_Environment * SDLCALL SDL_GetEnvironment(void);
|
|
extern SDL_DECLSPEC SDL_Environment * SDLCALL SDL_GetEnvironment(void);
|
|
|
|
|
|
|
|
/**
|
|
/**
|
|
|
- * Create a set of environment variables
|
|
|
|
|
|
|
+ * Create a set of environment variables.
|
|
|
|
|
+ *
|
|
|
|
|
+ * Note that on Windows, the variable names pulled in from the system, if
|
|
|
|
|
+ * `populated` is true, have their ASCII values uppercased, to match what most
|
|
|
|
|
+ * platforms expect even though the Windows system environment table is
|
|
|
|
|
+ * case-insensitive. Once those uppercased variable names are in an
|
|
|
|
|
+ * SDL_Environment, SDL treats them as case-sensitive.
|
|
|
*
|
|
*
|
|
|
* \param populated true to initialize it from the C runtime environment,
|
|
* \param populated true to initialize it from the C runtime environment,
|
|
|
* false to create an empty environment.
|
|
* false to create an empty environment.
|