ИМЯ¶

setenv - изменяет или добавляет переменную окружения

СИНТАКСИС¶

#include <stdlib.h>

int setenv(const char *name, const char *value, int overwrite);

int unsetenv(const char *name);

setenv(), unsetenv():

ОПИСАНИЕ¶

Функция setenv() добавляет переменную name в окружение со значением value, если name ещё не существует. Если name в окружении существует, то её значение изменяется на value, если overwrite имеет ненулевое значение; если overwrite равно нулю, то значение name не изменяется (и setenv() завершается без ошибки). Эта функция делает копию строк, указанных в name и value (в отличии от putenv(3)).

Функция unsetenv() удаляет переменную name из окружения. Если name в окружении не существует, то функция завершается без ошибки и окружение не изменяется.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

setenv() and unsetenv() functions return zero on success, or -1 on error, with errno set to indicate the cause of the error.

ОШИБКИ¶

EINVAL

Значение name равно NULL, указывает на строку нулевой длины или содержащую символ '='.

ENOMEM

Недостаточно памяти для добавления новой переменной в окружение.

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

СООТВЕТСТВИЕ СТАНДАРТАМ¶

POSIX.1-2001, POSIX.1-2008, 4.3BSD.

ЗАМЕЧАНИЯ¶

В POSIX.1 не требуется, чтобы setenv() или unsetenv() были реентерабельными.

До glibc 2.2.2, unsetenv() объявлялась как возвращающая void; более новые версии glibc следуют объявлению из POSIX.1, показанному в ОБЗОРЕ.

ДЕФЕКТЫ¶

В POSIX.1 указано, что если name содержит символ '=', то setenv() должна завершаться с ошибкой EINVAL; однако версии glibc до 2.3.4 допускали знак '=' в name.

СМ. ТАКЖЕ¶

clearenv(3), getenv(3), putenv(3), environ(7)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.