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 системной библиотеки