从字符串中读取指定长度的格式化数据。 这些功能有更安全的版本可用;请参阅 _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
一个或多个格式说明符。

...
可选变量,将用于存储通过 format 中的格式说明符从输入字符串中提取的值。

locale
要使用的区域设置。

返回值

这两个函数都将返回成功转换并分配的字段数;返回值不包括已读取但未分配的字段。 返回值为 0 表示没有分配任何字段。 如果在首次转换前到达字符串的结尾,则返回值为 EOF 以指示错误。 有关详细信息,请参阅 sscanf

如果 inputformat 是一个 NULL 指针,或如果 length 小于或等于 0,则将调用无效的参数处理程序,如参数验证中所述。 如果允许执行继续,则这些函数将返回 EOF 并将 errno 设置为 EINVAL

有关这些和其他错误代码的信息,请参阅 errno_doserrno_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

要求

例程 必需的标头
%> <stdio.h>
%> <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);
}
_snscanf converted 2 fields: 15 and 12.000000
_snwscanf converted 2 fields: 15 and 12.000000

另请参阅

scanf 宽度规范