setenv(3)

НАИМЕНОВАНИЕ
setenv - изменяет или добавляет переменную окружения

БИБЛИОТЕКА
Стандартная библиотека языка C (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-2008.

ИСТОРИЯ
POSIX.1-2001, 4.3BSD.

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

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

ОШИБКИ
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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (<debian-l10n-russian@lists.debian.org>).