searchpath

Функция            Просматривает маршрут в поисках файла.

Синтаксис          #include
                   char *searchpath(const char *filename);

Файл, содержащий   dir.h
прототип

Описание           Функция searchpath делает попытку найти файл с
                   именем filename, используя маршрут DOS, определя-
                   емый в переменной окружения PATH. Указатель на
                   полное имя маршрута файла возвращается в качестве
                   значения функции. Сначала просматривается текущая
                   директория рабочего диска. Если файл там не най-
                   ден, вызывается переменная операционной среды
                   PATH и каждая директория в маршруте PATH просмат-
                   ривается до тех пор, пока файл не будет найден
                   или маршрут не будет исчерпан.

                   Как только файл будет найден, возвращается стро-
                   ка, содержащая полное имя маршрута файла. Эта
                   строка затем может быть использована в вызовах
                   функций open или exec... для получения доступа к
                   файлу.

                   Возвращаемая строка с именем файла помещается в
                   static буфер и переписывается при каждом последу-
                   ющем вызове функции searchpath.

Возвращаемое       Если файл успешно найден, возвращается указатель
значение           на строку filename, в противном случае, функция
                   searchpath возвращает значение NULL.

Переносимость      Функция уникальна для DOS.

Смотрите также      exec.., findfirst findnext spawn.., system

Пример:

#include 
#include 

int main(void)
{
   char *p;
   p = searchpath("TLINK.EXE");
   printf("Маршрут для TLINK.EXE : %s\n", p);
   p = searchpath("NOTEXIST.FIL");
   printf("Маршрут для NOTEXIST.FIL : %s\n", p);
   return 0;
}

Вывод:
Маршрут для TLINK.EXE : C:\BIN\TLINK.EXE
Маршрут для NOTEXIST.FIL : (null)