_searchenv, _wsearchenv
使用环境路径搜索文件。 这些功能的更安全版本可用;请参见 _searchenv_s, _wsearchenv_s。
重要
此 API 不能在 Windows 运行时执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW。
void _searchenv(
const char *filename,
const char *varname,
char *pathname
);
void _wsearchenv(
const wchar_t *filename,
const wchar_t *varname,
wchar_t *pathname
);
template <size_t size>
void _searchenv(
const char *filename,
const char *varname,
char (&pathname)[size]
); // C++ only
template <size_t size>
void _wsearchenv(
const wchar_t *filename,
const wchar_t *varname,
wchar_t (&pathname)[size]
); // C++ only
参数
filename
搜索的文件的名称。varname
搜索的环境。pathname
存储完整路径的缓冲区。
备注
_searchenv 实例搜索在指定字段的目标文件。 varname 变量可以是任何环境或用户定义的变量 (例如、PATH、—指定目录路径列表的 LIB或 INCLUDE。 由于 _searchenv 区分大小写,varname 应与环境变量的大小写。
实例首先搜索在当前工作目录中的文件。 如果它没有找到文件,它通过环境变量指定的目录查找。 如果目标文件在这些目录之一,新创建的路径复制到 pathname。 如果找不到 filename 文件,pathname 包含一个空 null 终止的字符串。
pathname 缓冲区应长度为满足全长的至少 _MAX_PATH 字符构造的路径名。 否则,_searchenv 可能会超过 pathname 缓冲区和导致意外行为。
_wsearchenv 是 _searchenv的宽字符版本,并且,对于 _wsearchenv 的参数是宽字符字符串。 _wsearchenv 和 _searchenv 否则具有相同的行为。
如果 filename 是空字符串,这些函数返回 ENOENT。
如果 filename 或 pathname 是 NULL 指针,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 -1 并将 errno 到 EINVAL。
有关 errno 和错误代码的更多信息,请参见 errno常数。
在 C++ 中,这些函数的调用这些功能较新的模板超负载,更安全的副本。 有关更多信息,请参见安全模板重载。
一般文本例程映射
Tchar.h 实例 |
未定义的_UNICODE 和_MBCS |
定义的_MBCS |
定义的_UNICODE |
---|---|---|---|
_tsearchenv |
_searchenv |
_searchenv |
_wsearchenv |
要求
实例 |
必需的标头 |
---|---|
_searchenv |
<stdlib.h> |
_wsearchenv |
<stdlib.h> 或 <wchar.h> |
有关更多兼容性信息,请参见 兼容性。
示例
// crt_searchenv.c
// compile with: /W3
// This program searches for a file in
// a directory that's specified by an environment variable.
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
char pathbuffer[_MAX_PATH];
char searchfile[] = "CL.EXE";
char envvar[] = "PATH";
// Search for file in PATH environment variable:
_searchenv( searchfile, envvar, pathbuffer ); // C4996
// Note: _searchenv is deprecated; consider using _searchenv_s
if( *pathbuffer != '\0' )
printf( "Path for %s:\n%s\n", searchfile, pathbuffer );
else
printf( "%s not found\n", searchfile );
}
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见平台调用示例。