getenv()

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

Прототип:

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

Аргументы:

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

Библиотека:

libc

Описание:

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

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

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


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

Примеры:

#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 системной библиотеки