clearenv()

Очистить окружение

Прототип:

#include <stdlib.h>
int clearenv( void );

Библиотека:

libc

Описание:

The clearenv() function clears the environment area; no environment variables are defined immediately after the clearenv() call.

Note that clearenv() clears the following environment variables, which may then affect the operation of other library functions such as spawnp():

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

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

Коды ошибок:

ENOMEM
Not enough memory to allocate a control structure.

Примеры:

Clear the entire environment and set up a new TZ environment variable:

#include <stdio.h>
#include <stdlib.h>
int main( void )
{
if ( clearenv() != 0 )
{
puts( "Unable to clear the environment" );
return (EXIT_FAILURE);
}
setenv( "TZ", "EST5EDT", 0 );
return (EXIT_SUCCESS);
}

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

ЗОСРВ «Нейтрино»

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

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

The clearenv() function manipulates the environment pointed to by the global environ variable.

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

environ, errno, execl(), execle(), execlp(), execlpe(), execv(), execve(), execvp(), execvpe(), getenv(), putenv(), searchenv(), setenv(), spawn(), spawnl(), spawnle(), spawnlp(), spawnlpe(), spawnp(), spawnv(), spawnve(), spawnvp(), spawnvpe(), system(), unsetenv()




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