C++ Reference: Standard C++ Library reference: C Library: cwchar: fwscanf

C++官网参考链接：https://cplusplus.com/reference/cwchar/fwscanf/

函数 

fwscanf
int fwscanf (FILE* stream, const wchar_t* format, ...);
从流读取格式化的数据
从stream读取数据，并根据C宽字符串format将数据存储到附加实参所指向的位置。
附加实参应该指向format字符串中相应的格式说明符指定的已分配类型的对象。
文件中宽字符的外部表示形式是多字节字符：这些多字节字符被转换正如调用mbrtowc（使用stream的内部mbstate_t对象）。
这是fscanf（）的宽字符的等价函数。

形参 
stream 
指向FILE对象的指针，该对象标识要从中读取数据的输入流。
流还没有方向，或者是宽字符方向的（流上的第一个I/O操作决定它是面向字节的还是面向宽字符的，参见fwide）。
format 
C宽字符串，包含一个格式字符串，该格式字符串遵循与scanf中的format相同的规范（详细信息请参阅scanf）。
请注意，所有格式说明符的含义都与scanf中的含义相同；因此，%lc应用于读取宽字符（而不是%c）， %ls应用于宽字符串（而不是%s）。
...（附加实参） 
根据format字符串的不同，函数可能期望一个附加实参序列，每个实参包含一个指向已分配存储空间的指针，在该存储空间中，用适当的类型存储对提取字符的解释。
这些实参的数量至少应该与格式说明符存储的值的数量相同。函数将忽略额外的实参。

返回值
成功时，函数返回成功填充的实参列表的项数。由于匹配失败、读取错误或到达文件结束，此计数可以与预期的项数匹配，也可以更少（甚至为0）。
如果在读取过程中发生读取错误或到达文件结束，则设置适当的指示符（feof或ferror）。并且，如果在成功读取任何数据之前发生任何一种情况，则返回EOF。
如果在解释宽字符时发生编码错误，该函数将errno设置为EILSEQ。

用例
/* fwscanf example */
#include
#include

int main ()
{
  wchar_t str [80];
  float f;
  FILE * pFile;

  pFile = fopen ("myfile.txt","w+");
  fwprintf (pFile, L"%f %ls", 3.1416, L"PI");
  rewind (pFile);
  fwscanf (pFile, L"%f", &f);
  fwscanf (pFile, L"%ls", str);
  fclose (pFile);
  wprintf (L"I have read: %f and %ls \n",f,str);
  return 0;
}
这个示例代码创建了一个名为myfile.txt的文件，并向其中写入一个浮点数和一个字符串。然后，流被倒回并使用fwscanf读取两个值。它最终产生一个类似于：