从字符串中读取指定长度的格式化数据。 这些函数的版本是 _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 |
要求
例程 | 必需的标头 |
---|---|
%> | <stdio.h> |
%> | <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