PUTENV(3C)

НАЗВАНИЕ

putenv - изменение или расширение окружения

СИНТАКСИС

int putenv (string) char *string;

ОПИСАНИЕ

Аргумент string указывает на цепочку символов вида имя=значение. Функция putenv используется для присвоения переменной окружения имя заданного значения, при этом изменяется существующая переменная или создается новая. В любом случае цепочка, указанная аргументом string, становится частью окружения; таким образом, изменение этой цепочки приводит к изменению окружения.

Область памяти, на которую указывает string, становится ненужной после нового обращения к putenv с тем же именем.

СМ. ТАКЖЕ

, , , .

ДИАГНОСТИКА

Функция putenv возвращает ненулевое значение, если попытка получить дополнительное пространство памяти [посредством ] для расширенного окружения окончилась неудачей. Иначе возвращается ноль.

ПРЕДОСТЕРЕЖЕНИЯ

Функция putenv работает с окружением, указанным с помощью environ, и может быть использована вместе с функцией getenv. Однако envp (третий аргумент main) не изменяется.

При расширении окружения используется функция .

После вызова функции putenv алфавитная упорядоченность переменных окружения вообще говоря, нарушается.

Потенциальной ошибкой является вызов putenv с автоматической переменной в качестве аргумента, и последующий выход из вызывающей функции в то время, когда string еще является частью окружения.

Содержание раздела