2.4. Переменные окружения
Окружение представляет собой набор пар вида '
<i>имя</i>=<i>значение</i>
' для каждой программы. Эти пары называются
переменными окружения. Каждое имя состоит от одной до любого числа буквенно-цифровых символов или символов подчеркивания ('
_
'), но имя не может начинаться с цифры. (Это правило контролируется оболочкой; С API может помешать в окружение все, что захочет, за счет возможного запутывания последующих программ.)
Переменные окружения часто используются для управления поведением программ. Например, если в окружении существует
POSIXLY_CORRECT
, многие программы запрещают расширения или историческое поведение, которые несовместимы со стандартом POSIX.
Вы можете решить использовать (и должны задокументировать) переменные окружения для управления поведением вашей программы. Например, вы можете вместо аргумента командной строки использовать для опций отладки переменную окружения. Преимуществом использования переменных окружения является то, что пользователи могут установить их в своем загрузочном файле и не беспокоиться больше постоянным набором определенных опций в командной строке.
Конечно, недостатком использования переменных окружения является то, что они могут молча изменять поведение программы. Джим Мейеринг (Jim Meyering), сопроводитель Coreutils, выразил это таким образом:
Они упрощают пользователю настройку программы без изменения способа ее вызова. Это может быть как благословением, так и проклятием. Если вы пишете сценарий, который зависит от значения определенной переменной окружения, а затем этот сценарий использует еще кто-то, у кого нет таких же установок окружения, он легко может потерпеть неудачу (или, что еще хуже, молча выдать неверные результаты).
2.4.1. Функции управления окружением
Несколько функций позволяют получать значения переменных окружения, изменять эти значения или удалять их. Вот соответствующие объявления:
#include <stdlib.h>
char *getenv(const char *name);
/* ISO С: Получить переменную
окружения */
int setenv(const char *name, /* POSIX: Установить переменную */
const char *value, /* окружения */
int overwrite);
int putenv(char *string); /* XSI: Установить переменную
окружения, использует строку */
void unsetenv(const char *name); /* POSIX: Удалить переменную
окружения */
int clearenv(void); /* Общее: очистить все окружение */
Функция
getenv()
— та, которую вы будете использовать в 99% случаев. Ее аргументом является имя переменной окружения, которую нужно искать, такое, как «
НОМЕ
» или «
PATH
». Если переменная существует,
getenv()
возвращает указатель на строковое значение. Если нет, возвращается
NULL
. Например:
char *pathval;
/* Поиск PATH; если нет, использовать значение
по умолчанию */
if ((pathval = getenv("PATH")) == NULL)
pathval = "/bin:/usr/bin:/usr/ucb";
Иногда переменная окружения существует, но с пустым значением. В этом случае возвращаемое значение не равно
NULL
, но первый символ, на которую оно указывает, будет нулевым байтом, который в С является символом конца строки, '
'. Ваш код должен позаботиться проверить, что возвращаемое значение не равно NULL. Если оно не
NULL
, необходимо также проверить, что строка не пустая, если вы хотите для чего-то использовать значение переменной. В любом случае, не используйте возвращенное значение слепо.
Для изменения переменной окружения или добавления к окружению еще одной используется
setenv()
:
if (setenv("PATH", "/bin:/usr/bin:/usr/ucb", 1) != 0) {
/* обработать ошибку */
}
Возможно, что переменная уже существует в окружении. Если третий аргумент равен true (не ноль), новое значение затирает старое. В противном случае, предыдущее значение не меняется. Возвращаемое значение равно -1, если для новой переменной не хватило памяти, и 0 в противном случае.
setenv()
для сохранения в окружении делает индивидуальные копии как имени переменной, так и нового ее значения
Более простой альтернативой
setenv()
является
putenv()
, которая берет одну строку «
<i>имя</i>=<i>значение</i>
» и помещает ее в окружение:
if (putenv("PATH=/bin:/usr/bin:/usr/ucb") != 0) {
/* обработать ошибку */
}
putenv()
слепо заменяет любые предшествующие значения для той же переменной. А также, и это, возможно, более важно, строка, переданная
putenv()
, помещается непосредственно в окружение. Это означает, что если ваш код позже изменит эту строку (например, если это был массив, а не строковая константа), окружение также будет изменено. Это, в свою очередь, означает, что вам не следует использовать в качестве параметров для
putenv()
локальную переменную. По всем этим причинам
setenv()
является более предпочтительной функцией.
ЗАМЕЧАНИЕ. GNU
putenv()
имеет дополнительную (документированную) особенность в своем поведении. Если строка аргумента является именем без следующего за ним символа
=
, именованная переменная удаляется. Программа GNU
env
, которую мы рассмотрим далее в мой главе, полагается на такое поведение.
Функция
unsetenv()
удаляет переменную из окружения:
unsetenv("PATH");
Наконец, функция
clearenv()
полностью очищает окружение:
if (clearenv() != 0) {
/* обработать ошибку */
}
Эта функция не стандартизирована POSIX, хотя она доступна в GNU/Linux и нескольких коммерческих вариантах Unix. Ее следует использовать, если приложение должно быть очень безопасным и нужно построить собственное окружение с нуля. Если
clearenv()
недоступна, в справке GNU/Linux для
clearenv(3) рекомендуется использовать для выполнения этой задачи '
environ = NULL
'.
