_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

一个指定长度的 Reads 设置数据从字符串中。 这些是 _snscanf, _snscanf_l, _snwscanf, _snwscanf_l 的版本与安全增强的 CRT中的安全功能如中所述。

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format,
   ...
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   locale_t locale,
   ...
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   ...
);
int __cdecl _snwscanf_s_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_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

如果 input 或 format 是 NULL 指针,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 EOF 并将 errno 到 EINVAL。

有关这些属性和其他错误代码的信息,请参见 _doserrno、 errno、 _sys_errlist 和 _sys_nerr

备注

此功能类似于 sscanf_s ,但它能够指定字符的内置的编号从输入字符串检查。 有关更多信息,请参见 sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

缓冲区大小参数需要与类型字段字符 c、 C、 s、 S和 [。 有关更多信息,请参见 scanf类型字段字符

备注

大小参数是类型 unsigned,而不是 size_t。

这些功能的版本与 _l 后缀的相同,只不过它们使用区域设置参数而不是当前线程区域设置。

一般文本例程映射

Tchar.h 实例

未定义的 _UNICODE 和 _MBCS

定义的 _MBCS

定义的 _UNICODE

_sntscanf_s

_snscanf_s

_snscanf_s

_snwscanf_s

_sntscanf_s_l

_snscanf_s_l

_snscanf_s_l

_snwscanf_s_l

要求

实例

必需的头

_snscanf_s, _snscanf_s_l

stdio.h

_snwscanf_s, _snwscanf_s_l

stdio.h 或 wchar.h

有关更多兼容性信息,请参见中介绍的 兼容性

示例

// crt_snscanf_s.c
// This example scans a string of 
// numbers, using both the character
// and wide character secure versions
// of the snscanf function.

#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_s( str1, 6,  "%s %f", s1, 3, &fp);
    printf_s("_snscanf_s converted %d fields: ", i);
    printf_s("%s and %f\n", s1, fp);

    i = _snwscanf_s( str2, 6,  L"%s %f", s2, 3, &fp);
    wprintf_s(L"_snwscanf_s converted %d fields: ", i);
    wprintf_s(L"%s and %f\n", s2, fp);
}
  

.NET Framework 等效项

不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例

请参见

参考

scanf宽度规范