_snscanf、_snscanf_l、_snwscanf、_snwscanf_l

从字符串中读取一个指定长度的格式化数据。 提供这些函数的更多安全版本；请参见 _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 小于等于0, the invalid parameter handler is invoked, 将调用无效参数处理程序，如 参数验证中所述。 如果允许执行继续，则这些函数返回 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。有关更多信息，请参见平台调用示例。

请参见

参考

scanf 宽度规范