unsetenv()

Удалить переменную окружения

Прототип:

#include <stdlib.h>
int unsetenv( const char *name );

Аргументы:

name
Имя переменной окружения, которое будет удалено.

Библиотека:

libc

Описание:

Функция unsetenv() удаляет переменную окружения с именем name из окружения процесса. Если переменной с заданным именем не существует, unsetenv() завершится успехом и не изменит окружение.

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno. Окружение не изменено.

Коды ошибок:

EINVAL
Аргумент name равен NULL, указывает на пустую строку, или указывает на строку, содержащую символ равно (=).

Классификация:

POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Предостережения:

Функция unsetenv() манипулирует окружением, на которое указывает глобальная переменная environ.

Тематические ссылки:

clearenv(), getenv(), putenv(), setenv()




Предыдущий раздел: Описание API системной библиотеки