wscanf, fwscanf, swscanf, wscanf_s, fwscanf_s, swscanf_s
| 定义于头文件 <wchar.h>
|
||
| (1) | ||
| int wscanf( const wchar_t *format, ... ); |
(C95 起) (C99 前) |
|
| int wscanf( const wchar_t *restrict format, ... ); |
(C99 起) | |
| (2) | ||
| int fwscanf( FILE *stream, const wchar_t *format, ... ); |
(C95 起) (C99 前) |
|
| int fwscanf( FILE *restrict stream, const wchar_t *restrict format, ... ); |
(C99 起) | |
| (3) | ||
| int swscanf( const wchar_t *buffer, const wchar_t *format, ... ); |
(C95 起) (C99 前) |
|
| int swscanf( const wchar_t *restrict buffer, const wchar_t *restrict format, ... ); |
(C99 起) | |
| int wscanf_s( const wchar_t *restrict format, ...); |
(4) | (C11 起) |
| int fwscanf_s( FILE *restrict stream, const wchar_t *restrict format, ...); |
(5) | (C11 起) |
| int swscanf_s( const wchar_t *restrict s, const wchar_t *restrict format, ...); |
(6) | (C11 起) |
从各种资源读取数据，按照 format 转译，并存储结果于给定位置。
stream 读取数据。buffer 读取数据。抵达字符串结尾等价于 fwscanf 的抵达文件尾条件- 任何指针类型的参数为空指针
-
format、stream或buffer为空指针 - %c 、 %s 或 %[ 要写入的字符数加上空终止字符，会超出提供给这些转换指定符的第二个（ rsize_t ）参数
- 可选，任何其他可检测错误，例如未知转换指定符
- 同所有边界检查函数，
wscanf_s, fwscanf_s , swscanf_s仅若实现定义了 __STDC_LIB_EXT1__ ，且用户在包含<wchar.h>前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
| stream | - | 要读取的输入文件流 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| buffer | - | 指向要读取的空终止宽字符串的指针 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| format | - | 指向指定读取输入方式的空终止宽字符串的指针。
格式字符串由下列内容组成
下列格式说明符可用：
对于每个异于 所有异于 若不使用长度说明符 转换说明符 定宽整数类型（ 在每个转换说明符后有一个序列点；这允许存储多个域到同一“池”变量中。 在分析以无数字指数为结尾的不完整浮点值，如以转换说明符 %f 分析 "100er" 时，消耗序列 "100e" （可能为合法浮点数的最长前缀），并导致匹配错误（被消耗序列不能转换成浮点数），而留下 "r" 。某些既存实现不遵守此规则并回滚，通过消耗 "100" 而留下 "er" ，例如 glibc 漏洞 1765 。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ... | - | 接收参数 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
返回值
示例
Example
#include <stdio.h> #include <wchar.h> #include <string.h> #define NUM_VARS 3 #define ERR_READ 2 #define ERR_WRITE 3 int main(void) { wchar_t state[64]; // 州 wchar_t capital[64]; // 首府（州的首府） unsigned int population = 0; // 人口 int elevation = 0; // 高程 int age = 0; // 已设立时间 float pi = 0; // π（数学常数） // 交互模式 #if INTERACTIVE_MODE // 下列英文释义：输入州名，已设立时间和 π（数学常数） wprintf(L"Enter state, age, and pi value: "); if (wscanf(L"%ls%d%f", state, &age, &pi) != NUM_VARS) { // 输入错误 fprintf(stderr, "Error reading input.\n"); return ERR_READ; } #else // 下列英文释义：加利福尼亚州 170 3.141592 wchar_t* input = L"California 170 3.141592"; if (swscanf(input, L"%ls%d%f", state, &age, &pi) != NUM_VARS) { fprintf(stderr, "Error reading input.\n"); return ERR_READ; } #endif wprintf(L"State: %ls\nAge : %d years\nPi : %.5f\n\n", state, age, pi); FILE* fp = tmpfile(); if (fp) { // 向临时文件写入数据 // 下列英文释义：宽字符串内容：密西西比州 杰克逊首府 420000 807 if (!fwprintf(fp, L"Mississippi Jackson 420000 807")) { fprintf(stderr, "Error writing to file.\n"); fclose(fp); return ERR_WRITE; } // 倒回（rewind）文件指针 rewind(fp); // 将数据读入到变量 fwscanf(fp, L"%ls%ls%u%d", state, capital, &population, &elevation); // 下列英文释义：州名 首府 杰克逊人口 (2020年) 最大高程 wprintf(L"State : %ls\nCapital: %ls\nJackson population (in 2020): %u\n" L"Highest elevation: %dft\n", state, capital, population, elevation); fclose(fp); } }
可能的输出：
State: California Age : 170 years Pi : 3.14159 State : Mississippi Capital: Jackson Jackson population (in 2020): 420000 Highest elevation: 807ft
引用
- C11 标准（ISO/IEC 9899:2011）：
- 7.29.2.2 The fwscanf function (p: 410-416)
- 7.29.2.4 The swscanf function (p: 417)
- 7.29.2.12 The wscanf function (p: 421)
- K.3.9.1.2 The fwscanf_s function (p: 628-629)
- K.3.9.1.5 The swscanf_s function (p: 631)
- K.3.9.1.14 The wscanf_s function (p: 638)
- C99 标准（ISO/IEC 9899:1999）：
- 7.24.2.2 The fwscanf function (p: 356-362)
- 7.24.2.4 The swscanf function (p: 362)
- 7.24.2.12 The wscanf function (p: 366-367)
参阅
| (C99)(C99)(C99)(C11)(C11)(C11) |
从stdin、文件流或缓冲区读取格式化宽字符输入 使用可变参数列表 (函数) |