- bookworm 4.18.1-1
- bookworm-backports 4.21.0-2~bpo12+1
- testing 4.21.0-2
- unstable 4.21.0-2
setenv(3) | Library Functions Manual | setenv(3) |
ИМЯ¶
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);
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.
ОШИБКИ¶
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в 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.
СМ. ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан 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.
5 февраля 2023 г. | Linux man-pages 6.03 |