_snscanf, _snscanf_l, _snwscanf, _snwscanf_l
一个指定长度的 Reads 设置数据从字符串中。 这些功能的更安全版本可用; _snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l参见。
int __cdecl _snscanf(
const char * input,
size_t length,
const char * format,
...
);
int __cdecl _snscanf_l(
const char * input,
size_t length,
const char * format,
locale_t locale,
...
);
int __cdecl _snwscanf(
const wchar_t * input,
size_t length,
const wchar_t * format,
...
);
int __cdecl _snwscanf_l(
const wchar_t * input,
size_t length,
const wchar_t * format,
locale_t locale,
...
);
参数
input
检查的输入字符串。length
检查的字符数。 input。format
一个或多个格式说明符。... (optional)
将用于存储值的变量从输入字符串中提取了由 format的格式说明符。locale
使用的区域设置。
返回值
这两个函数返回成功转换和分配的字段数;返回值不包括读取,但未赋值的字段。 返回值为 0 表示字段未分配。 返回值是错误的 EOF ,或者该字符串的末尾在第一个转换之前为止。 有关更多信息,请参见 sscanf。
如果 input 或 format 是 NULL 指针,或者,如果 length 小于或等于零,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 EOF 并将 errno 到 EINVAL。
有关这些属性和其他错误代码的信息,请参见 _doserrno、 errno、 _sys_errlist 和 _sys_nerr。
备注
此功能类似于 sscanf ,但它能够指定字符的内置的编号从输入字符串检查。 有关更多信息,请参见 sscanf。
这些功能的版本与 _l 后缀的相同,只不过它们使用区域设置参数而不是当前线程区域设置。
一般文本例程映射
Tchar.h 实例 |
未定义的 _UNICODE 和 _MBCS |
定义的 _MBCS |
定义的 _UNICODE |
---|---|---|---|
_sntscanf |
_snscanf |
_snscanf |
_snwscanf |
_sntscanf_l |
_snscanf_l |
_snscanf_l |
_snwscanf_l |
要求
实例 |
必需的头 |
---|---|
_snscanf, _snscanf_l |
stdio.h |
_snwscanf, _snwscanf_l |
stdio.h 或 wchar.h |
有关更多兼容性信息,请参见中介绍的 兼容性 。
示例
// crt_snscanf.c
// compile with: /W3
#include <stdio.h>
int main( )
{
char str1[] = "15 12 14...";
wchar_t str2[] = L"15 12 14...";
char s1[3];
wchar_t s2[3];
int i;
float fp;
i = _snscanf( str1, 6, "%s %f", s1, &fp); // C4996
// Note: _snscanf is deprecated; consider using _snscanf_s instead
printf("_snscanf converted %d fields: ", i);
printf("%s and %f\n", s1, fp);
i = _snwscanf( str2, 6, L"%s %f", s2, &fp); // C4996
// Note: _snwscanf is deprecated; consider using _snwscanf_s instead
wprintf(L"_snwscanf converted %d fields: ", i);
wprintf(L"%s and %f\n", s2, fp);
}
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例。