_stprintf_s和_stscanf_s函数与UNICODE编码

_stprintf_s和_stscanf_s函数与UNICODE编码 
一、核心内容 
 该文档适用于微软的visual C++ 平台。  需要头文件：<TCHAR.H> 
 MSDN上对stprintf_s和_stscanf_s函数的定义：  

TCHAR.H routine   

_stprintf_s  _stscanf_s  

_UNICODE & _MBCS not defined  sprintf_s  sscanf_s

_MBCS defined    sprintf_s sscanf_s

_UNICODE defined   swprintf_s    swscanf_s 

对应的代码为： 
#ifdef UNICODE 
#define _stprintf_s    swprintf_s #else 
#define _stprintf_s    sprintf_s 
 前面的t表示编码，后面的_s表示检查内存溢出，前面的_表示非标准库函数。 
 从上我们可以看出，_stprintf_s和_stscanf_s是为适应不同编码而定义的两个宏，在不同的编码环境下他们所表示的函数是不同的。  _s是security的意思，具体含义参见后面的Security Remarks部分。  

（1）

int   sprintf_s( char *buffer, size_t sizeOfBuffer, const char *format [, argument] ... );  //ANSI版本 

int   swprintf_s(wchar_t *buffer, size_t sizeOfBuffer, const wchar_t *format [,argument]...); //UNICODE版本

           这个函数的主要作用是将若干个argument按照format格式存到buffer中。  
            buffer：输出的字符 

            sizeOfBuffer：buffer的长度，以能存放的字符数计算，而不是已占用的字节数计算。非常关键。一个UNICODE字符占用2个字节。        

format：格式字符串，比如%s            

argument：可选参数 

（2）

int   sscanf_s( const char *buffer, const char *format [, argument ] ... ); 

int   swscanf_s( const wchar_t *buffer, const wchar_t *format [, argument ] ... ); 
 
函数具体细节参考http://msdn.microsoft.com/en-us/library/t6z7bya3(v=vs.80).aspx 。 
     这个函数的主要作用是从buffer中读取指定格式（format）的字符到相应的argument中。参数同上 Security Remarks： 
Unlike the less secure version sscanf, a buffer size parameter sizeOfBuffer is required when using the type field characters c, C, s, S and [. This parameter must be supplied as an additional parameter after each buffer which requires it. 用于检查内存是否溢出。 几个需要注意的细节： 
 为了让编译器识别Unicode字符串，必须以在前面加一个“L”, 定义宽字节类型方法如下：L“ABC”，表示字符串“ABC”是用UNICODE编码
的。 
 char与wchar_t的区别： char中存放的是单字节型的字符，wchar_t中存放的是双字节型的字符，TCHAR在定义了_UNICODE时等同于wchar_t，
在未定义_UNICODE时等同于char。 
 
例子1 (sscanf_s和printf_s，用于ANSI编码)： 
// crt_sscanf_s.c 
// This program uses sscanf_s to read data items // from a string named tokenstring, then displays them.   

#include <stdio.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, sizeof(s) ); //对照上面的Security Remarks部分进行理解    

   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 );    

   return 0; } 

 
例子2 (swscanf_s和wprintf_s，用于UNICODE编码)： 

// crt_swscanf_s.c 
// This program uses swscanf_s to read data items // from a string named tokenstring, then displays them.   
#include <stdio.h>  
int main( void ) { 
   wchar_t  tokenstring[] = L"15 12 14...";    wchar_t  s[81];    wchar_t  c;    int   i;    float fp;  
   // Input various data from tokenstring: 
   // max 80 character string plus NULL terminator    cout<<sizeof(wchar_t)<<"  "<<_countof(s)<<endl; 
   swscanf_s( tokenstring, L"%s", s, _countof(s));  

   swscanf_s( tokenstring, L"%c", &c, sizeof(wchar_t) );    

   swscanf_s( tokenstring, L"%d", &i );    

   swscanf_s( tokenstring, L"%f", &fp );  

   // Output the data read 

   wprintf_s( L"String    = %s\n", s );    

   wprintf_s( L"Character = %c\n", c );    

   wprintf_s( L"Integer:  = %d\n", i ); 

   wprintf_s( L"Real:     = %f\n", fp );    

   return 0; } 

 
例子3 (_stscanf_s和_tprintf_s，将例1和例2的代码统一处理)： 
#include <stdio.h>  
int main( void ) { 
   TCHAR  tokenstring[] = TEXT("15 12 14...");    TCHAR  s[81];    TCHAR  c;    int   i;    float fp;  
   // Input various data from tokenstring: 
   // max 80 character string plus NULL terminator    cout<<sizeof(TCHAR)<<"  "<<_countof(s)<<endl; 

   _stscanf_s( tokenstring, TEXT("%s"), s, _countof(s));     

   _stscanf_s( tokenstring, TEXT("%c"), &c, sizeof(TCHAR) );    

   _stscanf_s( tokenstring, TEXT("%d"), &i );   

    _stscanf_s( tokenstring, TEXT("%f"), &fp );  

   // Output the data read 

   _tprintf_s( TEXT("String    = %s\n"), s );    

   _tprintf_s( TEXT("Character = %c\n"), c );

wchar_t *fgetws( wchar_t *string, int n, FILE *stream);   //UNICODE版本 
 其中，第二个参数n的值是最多可以读出的字符数目，该值不应该大于参数一所对应的字符数组的长度。 
 函数的作用是从第三个参数指定的文件流中读取文件的一行信息，存放到参数一string所对应的字符数组中，读出的字符数据包括换行符“\n”。这
一点需要注意。 
 如果想从键盘读入一行字符，第三个参数为 stdin . 例如，char buf[10];  fgets(buf, 10, stdin)   gets（）函数已经过时了，用fgets（）函数代替gets（）函数。 
 _fgetts是一个宏，如果定义了UNICODE，就是fgetws函数；如果未定义UNICODE，就是fgets函数。  用TCHAR代替char，用_fgetts代替fgets或fgetws。就将ANSI和UNICODE函数编码统一起来了。 对这两个函数的更具体的讲解，请参考http://wenku.baidu.com/view/d66839f57c1cfad6195fa781.html 
3. ANSI和UNICODE字符和字符串处理函数，参考网页http://blog.sina.com.cn/s/blog_6b5a0745010108fh.html 
  统一ANSI和UNICODE字符和字符串处理函数的宏定义，在上述网页中没有列出，这些宏的规律是“把UNICODE字符和字符串处理函数中的w标识替换为t，并在前面加上一个下划线_”。例如， 
TCHAR.H routine 
_UNICODE defined 
_MBCS defined 
_UNICODE & _MBCS not defined 
_tcslen 
wcslen 
strlen 
strlen 
_fgetts fgetws fgets fgets _tcsncpy 
wcsncpy 
strncpy 
strncpy 
 
4. 注意：如果在程序中使用了TCHAR，那么就不应该使用ANSI的strXXX函数或者Unicode的wcsXXX函数了，而必须使用tchar.h中定义的_tcsXXX函数。 
5. 有人建议，不要再使用TCHAR和_T了！他分析了原因后总结：如果您正开始一个新的项目，请无论如何也要顶住压力，直接使用UNICODE编码！切记！您只需要对您的组员进行10分钟的培训，记住strcpy用 wcscpy，sprintf用swprintf代替，常数前加L，就可以了！它不会花您很多时间的，带给您的是稳定和安全！个人觉得有道理。