searchpath, wsearchpath

Nach oben zu dir.h - Index

Header-Datei

dir.h

Kategorie

Verschiedene Routinen

Prototyp

char *searchpath(const char *file);

wchar_t *wsearchpath( const wchar_t *file );

Beschreibung

Sucht im Betriebssystempfad nach einer Datei.

searchpath durchsucht die in der Umgebungsvariablen "PATH=..." angegebenen Verzeichnissen nach einer Datei. Als Funktionswert wird ein String mit dem kompletten Pfadnamen zurückgegeben.

searchpath sucht zuerst im aktuellen Verzeichnis des aktuellen Laufwerks nach der Datei. Wird die Datei hier nicht gefunden, wird die Umgebungsvariable PATH abgerufen, und die in PATH enthaltenen Verzeichnisse werden nacheinander durchsucht, bis die Datei gefunden wurde oder die Pfadangabe keine Verzeichnisse mehr enthält.

Wenn die Datei gefunden wird, wird ein String mit dem vollständigen Pfadnamen zurückgegeben. Dieser String kann einer Funktion übergeben werden, um auf die Datei zuzugreifen (z. B. mit fopen oder exec).

Der zurückgegebene String befindet sich in einem statischen Puffer und wird durch jeden nachfolgenden Aufruf von searchpath überschrieben.

Rückgabewert

searchpath gibt einen Zeiger auf den String mit dem Dateinamen zurück, wenn die Datei gefunden wurde. Andernfalls gibt searchpath Null zurück.

Beispiel

 #include <stdio.h>
 #include <dir.h>
 int main(void)
 {
     char *p;
     /* Sucht nach ILINK32 und gibt einen Zeiger
        auf den Pfad zurück */
     p = searchpath("ILINK32.EXE");
     printf("Search for ILINK32.EXE : %s\n", p);
     /* Sucht nach einer nicht vorhandenen Datei */
     p = searchpath("NOTEXIST.FIL");
     printf("Search for NOTEXIST.FIL : %s\n", p);
     return  0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
searchpath		+
wsearchpath		Nur NT