ИМЯ

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

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <stdlib.h>

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

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       setenv(), unsetenv():
           _POSIX_C_SOURCE >= 200112L
               || /* glibc <= 2.19: */ _BSD_SOURCE

ОПИСАНИЕ

       Функция  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 error.

ОШИБКИ

       EINVAL name is NULL, points to a string of length 0, or contains an '=' character.

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

АТРИБУТЫ

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

       ┌────────────────────────────────────────────┬──────────────────────┬─────────────────────┐
       │Интерфейс                                   │ Атрибут              │ Значение            │
       ├────────────────────────────────────────────┼──────────────────────┼─────────────────────┤
       │setenv(), unsetenv()                        │ Безвредность в нитях │ MT-Unsafe const:env │
       └────────────────────────────────────────────┴──────────────────────┴─────────────────────┘

СТАНДАРТЫ

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

ЗАМЕЧАНИЯ

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

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

ДЕФЕКТЫ

       POSIX.1 specifies that if name contains an '=' character, then setenv()  should fail  with
       the  error  EINVAL;  however,  versions of glibc before glibc 2.3.4 allowed an '=' sign in
       name.

СМ. ТАКЖЕ

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

ПЕРЕВОД

       Русский   перевод   этой   страницы   руководства    был    сделан    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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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