getenv()

Получить значение переменной окружения

Прототип:

#include <stdlib.h>
                                       
char * getenv( const char *name );

Аргументы:

name

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

Библиотека:

libc

Описание:

Функция getenv() ищет в списке окружения строку вида name=value и возвращает указатель на строку, содержащую value для заданного name. Сравнение строк чувствительно к регистру.

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

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

---

Не изменяйте возвращаемую строку!

---

Примеры:

#include <stdio.h>
#include <stdlib.h>
                                       
int main( void )
{
    char    *path;
                                       
    path = getenv( "INCLUDE" );
    if ( path != NULL )
    {
        printf( "INCLUDE=%s\n", path );
        return (EXIT_SUCCESS);
    }
        
    return (EXIT_FAILURE);
}

Классификация:

ANSI, POSIX 1003.1

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

Предостережения:

Функция getenv() оперирует с окружением, на которое указывает глобальная переменная environ.

Тематические ссылки:

clearenv(), environ, execl(), execle(), execlp(), execlpe(), execv(), execve(), execvp(), execvpe(), putenv(), searchenv(), setenv(), spawn*(), system()

Предыдущий раздел: Описание API системной библиотеки