Function

GLibgetenv

Declaration

const gchar*
g_getenv (
  const gchar* variable
)

Description

Returns the value of an environment variable.

On UNIX, the name and value are byte strings which might or might not be in some consistent character set and encoding. On Windows, they are in UTF-8. On Windows, in case the environment variable’s value contains references to other environment variables, they are expanded.

Parameters

variable const gchar*
 

The environment variable to get.

 The data is owned by the caller of the function.
 The string is a file system path, using the OS encoding.

Return value

Returns: filename
 

The value of the environment variable, or NULL if the environment variable is not found. The returned string may be overwritten by the next call to g_getenv(), g_setenv() or g_unsetenv().

 The data is owned by the called function.
 The string is a file system path, using the OS encoding.