std::getenv

 

C++

Язык

Заголовочные файлы

Концепты

Поддержка языка

Ошибка

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод/вывод

Локализация

Регулярные выражения (C++11)

Атомарные операции (C++11)

Потоки (C++11)

Файловая система (C++17)

Технические спецификации

 

Утилиты библиотеки

Поддежка типов (базовые типы, RTTI, type traits)

Динамическое управление памятью

Обработка ошибок

Управление жизненным циклом программы

Функции с переменным числом аргументов

Дата и время

Функциональные объекты

initializer_list (C++11)

bitset

hash (C++11)

Реляционные операторы

rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=

Пары и кортежи

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Обмен, передача и перемещение

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Коммунальные услуги Программа поддержки

Программа прекращения Оригинал: Program termination Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
abort exit quick_exit (C++11) _Exit (C++11)	atexit at_quick_exit (C++11) EXIT_SUCCESSEXIT_FAILURE
Взаимодействие с окружающей средой Оригинал: Communicating with the environment Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
system	getenv
Сигналы Оригинал: Signals Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
Сигнал типа Оригинал: Signal types Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM
Нелокальные переходы Оригинал: Non-local jumps Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
setjmp
longjmp
Типы Оригинал: Types Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
jmp_buf

 

Определён в заголовочном файле <cstdlib>
char* getenv( const char* env_var );

Ищет в списке переменных среды, возвращаемом окружением (операционной системой) строку, соответствующую указателю на строку в стиле Си, указанной в env_var, и возвращает указатель на строку в стиле Си, которая содержит значение найденной переменной среды.

Эта функция не гарантирует потокобезопасность. Другой вызов getenv, также как и вызов POSIX-функций setenv(), unsetenv() и putenv() может очистить указатель, возвращенный при предыдущем вызове, или модифицировать строку, полученную при предыдущем вызове.	(до C++11)
Эта функция потокобезопасна (вызов её из нескольких потоков не приведёт к условиям гонки), до тех пор пока другие функции не внесут изменения в переменные среды. В том числе с помощью POSIX-функций setenv(), unsetenv() и putenv(). Они могут привести к условиям гонки, если их вызовы не будут синхронизированы.	(начиная с C++11)

Изменение строки, возвращенной getenv, может привести к неопределённому поведению.

Параметры

env_var

—

Нуль-завершенная строка, которая содержит название переменной среды для поиска.

Возвращаемое значение

Строка в стиле Си, которая содержит значение переменной среды или нулевой указатель, если такая переменная не была найдена.

Примечание

На POSIX системах, переменные среды также доступны с помощью глобальной переменной environ, определённой как extern char **environ; в <unistd.h>, и через опциональный третий параметр в функции main.

Пример

Запустить этот код

#include <iostream>
#include <cstdlib>
 
int main()
{
    if(const char* env_p = std::getenv("PATH"))
        std::cout << "Your PATH is: " << env_p << '\n';
}

Возможный вывод:

Your PATH is: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games

См. также

Справка по C — getenv