clearenv()

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

Прототип:

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

Библиотека:

libc

Описание:

Функция clearenv() очищает область окружения; сразу после вызова clearenv() ни одна переменная окружения не остается объявленной.

Следует помнить, что clearenv() очищает следующие переменные окружения, которые могут повлиять на работу других библиотечных функций, например, spawnp():

• PATH
• SHELL
• TERM
• TERMINFO
• LINES
• COLUMNS
• TZ

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

0

Успешное завершение.

-1

Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

ENOMEM

Недостаточно памяти для создания управляющей структуры.

Примеры:

Очистить окружение и установить новую переменную окружения TZ:

#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);
}

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

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

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

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

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

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

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