sscanf_s、_sscanf_s_l、swscanf_s、_swscanf_s_l
从字符串中读取格式化数据。 sscanf、_sscanf_l、swscanf、_swscanf_l 的这些版本如 CRT 中的安全功能 所述,其安全得到了增强。
int sscanf_s(
const char *buffer,
const char *format [,
argument ] ...
);
int _sscanf_s_l(
const char *buffer,
const char *format,
locale_t locale [,
argument ] ...
);
int swscanf_s(
const wchar_t *buffer,
const wchar_t *format [,
argument ] ...
);
int _swscanf_s_l(
const wchar_t *buffer,
const wchar_t *format,
locale_t locale [,
argument ] ...
);
参数
buffer
已存储的数据format
窗体控件字符串。 有关详细信息,请参阅格式规范字段:scanf 和 wscanf 函数。argument
可选参数locale
要使用的区域设置
返回值
每个函数返回成功转换并分配的字段数量;返回值不包括已读取但未分配的字段。 返回值为 0 表示未分配字段。 如果出现错误,或者,如果在第一个转换之前到达字符串的末尾,则返回值是 EOF。
如果 buffer 或 format 是 NULL 指针,无效参数处理器程序将按 参数验证 中所述进行调用。 如果允许执行继续,则这些函数返回 -1 并将 errno 设置为 EINVAL
有关这些属性和其他错误代码的更多信息,请参见 errno、_doserrno、_sys_errlist 和 _sys_nerr。
备注
sscanf_s 函数读取 buffer 的数据到每个 argument给出的位置。 在格式字符串之后的参数指定指向具有类型的变量,此类型必须对应于 format 中的类型说明符。 不同于较不安全的版本 sscanf,当你使用类型字段字符 c、C、s、 S 或封闭在 [] 中的字符串控件集时,需要设置缓冲区域大小参数。 字符中的缓冲区区域大小必须作为其他参数提供,紧跟需要其的每个缓冲区参数。 例如,如果正读入字符串,该字符串的缓冲区区域大小的传递如下所示:
wchar_t ws[10];
swscanf_s(in_str, L"%9s", ws, _countof(ws)); // buffer size is 10, width specification is 9
缓冲区大小区域包括终止 null。 宽度规范字段可用于确保读取的标记将放入缓冲区。 如果未使用宽度规范字段,而标记读入又太大以致无法容纳在缓冲区中,则该缓冲区将不写入任何内容。
就字符而言,单个字符的可能被读取,如下所示:
wchar_t wc;
swscanf_s(in_str, L"%c", &wc, 1);
此示例读取输入字符串的单个字符然后将它保存在宽字符缓冲区中。 当您读取多个字符的非 null 终止的字符串时,无符号整数作为宽度规范和区域缓冲区大小。
char c[4];
sscanf_s(input, "%4c", &c, _countof(c)); // not null terminated
有关更多信息,请参见scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l和scanf 类型字段字符。
备注
大小参数的类型为 unsigned 而非 size_t。
format 参数控制输入字段的解释,并且形式和函数都与 scanf_s 功能的 format 参数相同。 如果复制出现在重叠的字符串之间,则该行为不确定。
swscanf_s 是 sscanf_s; 的宽字符版本swscanf_s 的参数是宽字符字符串。 sscanf_s 不处理多字节十六进制字符。 swscanf_s 不处理 Unicode 全角十六进制或“兼容性区域”字符。 否则,swscanf_s 和 sscanf_s 行为相同。
这些带有_l后缀的函数的版本相同,除了它们传递的是区域设置参数而不是当前线程区域设置。
一般文本例程映射
TCHAR.H 例程 |
未定义 _UNICODE & _MBCS |
已定义 _MBCS |
已定义 _UNICODE |
---|---|---|---|
_stscanf_s |
sscanf_s |
sscanf_s |
swscanf_s |
_stscanf_s_l |
_sscanf_s_l |
_sscanf_s_l |
_swscanf_s_l |
要求
例程 |
必需的标头 |
---|---|
sscanf_s, _sscanf_s_l |
<stdio.h> |
swscanf_s, _swscanf_s_l |
<stdio.h> 或 <wchar.h> |
有关其他兼容性信息,请参见兼容性。
示例
// crt_sscanf_s.c
// This program uses sscanf_s to read data items
// from a string named tokenstring, then displays them.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
char tokenstring[] = "15 12 14...";
char s[81];
char c;
int i;
float fp;
// Input various data from tokenstring:
// max 80 character string plus NULL terminator
sscanf_s( tokenstring, "%s", s, _countof(s) );
sscanf_s( tokenstring, "%c", &c, sizeof(char) );
sscanf_s( tokenstring, "%d", &i );
sscanf_s( tokenstring, "%f", &fp );
// Output the data read
printf_s( "String = %s\n", s );
printf_s( "Character = %c\n", c );
printf_s( "Integer: = %d\n", i );
printf_s( "Real: = %f\n", fp );
}
.NET Framework 等效项
请参见 Parse 方法,如 System::Double::Parse。
请参见
参考
fscanf、_fscanf_l、fwscanf、_fwscanf_l
scanf、_scanf_l、wscanf、_wscanf_l