searchpath

searchpath

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

Синтаксис          #include<dir.h>
                   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 <stdio.h>
#include <dir.h>

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)