_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

  • 项目

从字符串中读取指定长度的格式化数据。 这些函数的版本是 _snscanf、_snscanf_l、_snwscanf、_snwscanf_l，具有安全性增强功能，如 CRT 中的安全功能中所述。

语法

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format [, argument_list]
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale [, argument_list]
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format [, argument_list]
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale [, argument_list]
);

参数

input
要检查的输入字符串。

length
input 中要检查的字符数。

format
一个或多个格式说明符。

locale
要使用的区域设置。

argument_list
要根据格式字符串分配的可选参数。

返回值

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

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

有关这些和其他错误代码的信息，请参阅 、errno、_doserrno、_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);
}

_snscanf_s converted 2 fields: 15 and 12.000000
_snwscanf_s converted 2 fields: 15 and 12.000000

另请参阅

scanf 宽度规范