Unix Man (Справочное руководство)


PUTENV(3C)


PUTENV(3C)

НАЗВАНИЕ


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

СИНТАКСИС

int putenv (string) char *string;

ОПИСАНИЕ


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

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

СМ. ТАКЖЕ


, , , .

ДИАГНОСТИКА


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

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


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

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

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

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




Начало  Назад  Вперед