Function

GLibenviron_unsetenv

since: 2.32

Declaration

gchar**
g_environ_unsetenv (
  gchar** envp,
  const gchar* variable
)

Description

Removes the environment variable variable from the provided environment envp.

Available since: 2.32

Parameters

envp

Type: An array of filename

an environment list that can be freed using `g_strfreev()` (e.g., as
returned from g_get_environ()), or `NULL` for an empty environment list.

The argument can be NULL.
The array must be NULL-terminated.
The called function takes ownership of the data, and is responsible for freeing it.
Each element is a file system path, using the OS encoding.
variable

Type: const gchar*

The environment variable to remove, must not contain ‘=’

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

Return value

Type: An array of filename

the updated environment list. Free it using g_strfreev().
The array is NULL-terminated.
The caller of the function takes ownership of the data, and is responsible for freeing it.
Each element is a file system path, using the OS encoding.