searchpath,wsearchpath
dir.h:インデックス への移動
ヘッダーファイル
dir.h
カテゴリ
その他のルーチン
プロトタイプ
char *searchpath(const char *file);
wchar_t *wsearchpath( const wchar_t *file );
説明
オペレーティングシステムのパスからファイルを検索します。
searchpath は,オペレーティングシステムのパス(環境変数の PATH=... 文字列)を順に検索してファイルを見つけます。絶対パス名文字列を指すポインタが関数値として返されます。
searchpath は,最初に現在のドライブの現在のディレクトリでファイルを検索します。そこにファイルが見つからなければ,PATH 環境変数を取得し,ファイルが見つかるか,すべてのパスを調べ終わるまで,パス内の各ディレクトリを順番に検索します。
ファイルが見つかると,絶対パス名を含む文字列が返されます。この文字列は,ファイルにアクセスするための呼び出し(fopen,exec... など)で使用できます。
返される文字列は静的バッファに置かれ,その後 searchpath を呼び出すたびに上書きされます。
戻り値
ファイルが見つかった場合,searchpath はファイル名文字列を指すポインタを返します。そうでない場合は,null を返します。
例
#include <stdio.h>
#include <dir.h>
int main(void)
{
char *p;
/* ILINK32 を検索し,そのパスを指すポインタを
返します */
p = searchpath("ILINK32.EXE");
printf("Search for ILINK32.EXE : %s\n", p);
/* 存在しないファイルを検索します */
p = searchpath("NOTEXIST.FIL");
printf("Search for NOTEXIST.FIL : %s\n", p);
return 0;
}
移植性
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
searchpath |
+ |
|||
wsearchpath |
NT のみ |