searchenv()

Искать в директориях, указанных в переменной окружения

Прототип:

#include <stdlib.h>
void searchenv( const char *name,
const char *env_var,
char *buffer );

Аргументы:

name
The name of the file that you want to search for.
env_var
The name of an environment variable whose value is a list of directories that you want to search. Common values for env_var are PATH, LIB and INCLUDE.

Note: The searchenv() function doesn't search the current directory unless it's specified in the environment variable.

buffer
A buffer where the function can store the full path of the file found. This buffer should be PATH_MAX bytes long. If the specified file can't be found, the function stores an empty string in the buffer.

Библиотека:

libc

Описание:

The searchenv() function searches for the file specified by name in the list of directories assigned to the environment variable specified by env_var.


Note: Use pathfind() or pathfind_r() instead of this function.

Примеры:

#include <stdio.h>
#include <stdlib.h>
#include <limits.h>
void display_help( FILE *fp )
{
printf( "display_help T.B.I.\n" );
}
int main( void )
{
FILE *help_file;
char full_path[ PATH_MAX ];
searchenv( "lib_ref.html", "PATH", full_path );
if ( full_path[0] == '\0' )
{
printf( "Unable to find help file\n" );
} else {
help_file = fopen( full_path, "r" );
display_help( help_file );
fclose( help_file );
}
return (EXIT_SUCCESS);
}

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

ЗОСРВ «Нейтрино»

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

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

The searchenv() function manipulates the environment pointed to by the global environ variable.

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

getenv(), pathfind(), pathfind_r(), setenv()




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