class File
{
public:
 virtual int open(const string & filename)=0;
 virtual int close(const string & filename)=0;
 //
 virtual ~File()=0; // 记住添加纯虚拟析构函数（dtor）
};

class DiskFile: public File
{
public:
 int open(const string & filename);

 // 实现其他的纯虚拟函数
    ......

 // 自己的专有操作
 virtual int flush();
 virtual int defragment();
};    

class TextFile: public DiskFile
{
  // ......
  int  sort_by_words();
};

class MediaFile: public DiskFile
{
  //......
};        

File *pfile; // *pfile的静态类型是 File
if(some_condition)
  pfile = new TextFile; // 动态类型是 TextFile
else
  pfile = new DiskFile; // 动态类型是 DiskFile       

#include <typeinfo> // typeid 需要的头文件
void menu::build(const File * pfile)
{
 if (typeid(*pfile)==typeid(TextFile))
 {
  add_option("edit"); 
 }
 else if (typeid(*pfile)==typeid(MediaFile))
 {
 add_option("play"); 
 }
}      

void menu::build(const File * pfile)
{

 //......

  else if (typeid(*pfile)==typeid(LocalizedMedia))
 {
  add_option("play"); 
  }
}     

void menu::build(const File * pfile)
{
 if (dynamic_cast <MediaFile *> (pfile))
 {
  // pfile 是 MediaFile 或者是MediaFile的派生类 LocalizedMedia
  add_option("play"); 
 }
 else if (dynamic_cast <TextFile*> (pfile))
 {
  // pfile 是 TextFile 是TextFile的派生类
  add_option("edit"); 
 }
}    

Using MFC to Automate SAPI

Introduction

The Microsoft Foundation Classes (MFC) provides an easy and convenient way to automate calls to SAPI using its Class Wizard to generate wrappers for the SAPI layer from the SAPI Type Library.

In order to accomplish this, perform the following steps:

1. Create a new MFCAppWizard(exe) project in Visual C++.
2. Based on the type of application you are creating, follow the wizard prompts. In Step 3 of the wizard prompts, (or Step 2 if you are creating a Dialog Based application) make sure that the Automation check box is selected under the heading, What other support would you like to include?

Once the new project is ready, access Class Wizard.

1. Click the Automation tab, and then click Add Class and select From a type library in the drop-down list.
2. Browse for the sapi.dll file and open it.
3. Select the classes you would like Class Wizard to generate a wrapper for. The resulting default header and implementation files are sapi.h and sapi.cpp respectively. The rest of this document assumes that you have chosen to use these default file names. Click OK.
4. You should now be back in the Class Wizard window. Click OK.

Upon viewing the sapi.h file, you should notice that it is nothing more than an automation wrapper that has been generated for all the classes you selected. Notice that all the classes inherit from COleDispatchDriver, hence the dispatch interface needs to be set up. This only requires a few lines of simple code, after which the wrapper class can be used just like any other C++ class.

Example

This example assumes that you chose to generate a wrapper for the ISpeechVoice class from among any other classes you may have selected. Using the project created above, include the sapi.h file within a source file in the project that will make automation calls to SAPI using the wrapper. In that source file, type the following code.

CLSID CLSID_SpVoice;    // class ID for the SAPI SpVoice object
LPDISPATCH pDisp;       // dispatch interface for the class
ISpeechVoice voice;     // use the MFC Class Wizard generated wrapper

CLSIDFromProgID(L"SAPI.SpVoice", &CLSID;_SpVoice);
voice.CreateDispatch(CLSID_SpVoice);
pDisp = voice.m_lpDispatch;

HRESULT hr = pDisp->QueryInterface(CLSID_SpVoice, (void**)&voice;.m_lpDispatch);

if (hr == S_OK) {
    pDisp->Release();
}
else {
    voice.AttachDispatch(pDisp, TRUE);
}

voice.Speak("hello world", 1);   // asynchronous call to Speak method of ISpeechVoice interface

If you have been following the steps outlined above properly, you should hear your computer say "hello world!" That's all there is to using MFC to make automation calls to SAPI. Currently however, not all the wrapper classes generated by MFC's Class Wizard work properly. For instance, the ISpeechLexicon interface does not work. The work around for this is to implement your own automation wrapper classes using C++. The steps to do that are beyond the scope of this document. Of course, you can always use the COM interfaces in C++ and Automation in Visual Basic to ensure that every interface in SAPI works easily and flawlessly.

_tcsncpy_l 后缀  _l 不推荐使用的函数

_tcsncpy_s 后缀  _s Security Enhancements in the CRT

_tcsncpy_s_l 后缀  _s_l 同 _s

security enhancements

宽字符处理函数函数与普通函数对照表 
  
 

字符分类：     宽字符函数普通C函数描述 
iswalnum（）     isalnum（） 测试字符是否为数字或字母 
iswalpha（）     isalpha（） 测试字符是否是字母 
iswcntrl（）     iscntrl（） 测试字符是否是控制符 
iswdigit（）     isdigit（） 测试字符是否为数字 
iswgraph（）     isgraph（） 测试字符是否是可见字符 
iswlower（）     islower（） 测试字符是否是小写字符 
iswprint（）     isprint（） 测试字符是否是可打印字符 
iswpunct（）     ispunct（） 测试字符是否是标点符号 
iswspace（）     isspace（） 测试字符是否是空白符号 
iswupper（）     isupper（） 测试字符是否是大写字符 
iswxdigit（）     isxdigit（）测试字符是否是十六进制的数字 


大小写转换：     
宽字符函数    普通C函数描述 
towlower（）     tolower（） 把字符转换为小写 
towupper（）     toupper（） 把字符转换为大写 


字符比较：     宽字符函数普通C函数描述 
wcscoll（）     strcoll（） 比较字符串 


日期和时间转换： 
宽字符函数描述 
strftime（）     根据指定的字符串格式和locale设置格式化日期和时间 
wcsftime（）     根据指定的字符串格式和locale设置格式化日期和时间， 并返回宽字符串 
strptime（）     根据指定格式把字符串转换为时间值， 是strftime的反过程 


打印和扫描字符串： 
宽字符函数描述 
fprintf（）

fwprintf（）     使用vararg参量的格式化输出 
fscanf（）

fwscanf（）         格式化读入 
printf（）             使用vararg参量的格式化输出到标准输出 
scanf（）             从标准输入的格式化读入 
sprintf（）

swprintf（）     根据vararg参量表格式化成字符串 
sscanf（）             以字符串作格式化读入 
vfprintf（）

vfwprintf（）     使用stdarg参量表格式化输出到文件 
vprintf（）             使用stdarg参量表格式化输出到标准输出 
vsprintf（）

vswprintf（）     格式化stdarg参量表并写到字符串 


数字转换： 
宽字符函数    普通C函数描述 
wcstod（）     strtod（）  把宽字符的初始部分转换为双精度浮点数 
wcstol（）     strtol（）  把宽字符的初始部分转换为长整数 
wcstoul（）     strtoul（） 把宽字符的初始部分转换为无符号长整数 


多字节字符和宽字符转换及操作： 
宽字符函数描述 
mblen（）         根据locale的设置确定字符的字节数 
mbstowcs（）         把多字节字符串转换为宽字符串 
mbtowc（）

btowc（）    把多字节字符转换为宽字符 
wcstombs（）         把宽字符串转换为多字节字符串 
wctomb（）

wctob（）     把宽字符转换为多字节字符 


输入和输出： 
宽字符函数    普通C函数描述 
fgetwc（）     fgetc（）     从流中读入一个字符并转换为宽字符 
fgetws（）     fgets（）     从流中读入一个字符串并转换为宽字符串 
fputwc（）     fputc（）     把宽字符转换为多字节字符并且输出到标准输出 
fputws（）     fputs（）     把宽字符串转换为多字节字符并且输出到标准输出串 
getwc（）     getc（）     从标准输入中读取字符， 并且转换为宽字符 
getwchar（）     getchar（）     从标准输入中读取字符， 并且转换为宽字符 
None         gets（）     使用fgetws（） 
putwc（）     putc（）     把宽字符转换成多字节字符并且写到标准输出 
putwchar（）     putchar（）     把宽字符转换成多字节字符并且写到标准输出 
None         puts（）     使用fputws（） 
ungetwc（）     ungetc（）     把一个宽字符放回到输入流中 


字符串操作： 
宽字符函数        普通C函数描述 
wcscat（）         strcat（）     把一个字符串接到另一个字符串的尾部 
wcsncat（）         strncat（）     类似于wcscat（）， 而且指定粘接字符串的粘接长度. 
wcschr（）         strchr（）     查找子字符串的第一个位置 
wcsrchr（）         strrchr（）     从尾部开始查找子字符串出现的第一个位置 
wcspbrk（）         strpbrk（）     从一字符字符串中查找另一字符串中任何一个字符第一次出现的位置 
wcswcs（）

wcsstr（）     strchr（）     在一字符串中查找另一字符串第一次出现的位置 
wcscspn（）         strcspn（）     返回不包含第二个字符串的的初始数目 
wcsspn（）         strspn（）     返回包含第二个字符串的初始数目 
wcscpy（）         strcpy（）     拷贝字符串 
wcsncpy（）         strncpy（）     类似于wcscpy（）， 同时指定拷贝的数目 
wcscmp（）         strcmp（）     比较两个宽字符串 
wcsncmp（）         strncmp（）     类似于wcscmp（）， 还要指定比较字符字符串的数目 
wcslen（）         strlen（）     获得宽字符串的数目 
wcstok（）         strtok（）     根据标示符把宽字符串分解成一系列字符串 
wcswidth（）         None         获得宽字符串的宽度 
wcwidth（）         None         获得宽字符的宽度 


另外还有对应于memory操作的 wmemcpy（）， wmemchr（）， wmemcmp（）， wmemmove（）， wmemset（）．

#include <stdio.h>
#include <dshow.h>
// change here
#define	FILENAME L"C:\\DXSDK\\Samples\\Media\\butterfly.mpg"
// note that this sample fails on some environment
int
main()
{
IGraphBuilder *pGraphBuilder;
IMediaControl *pMediaControl;
IBasicVideo *pBasicVideo;
CoInitialize(NULL);
CoCreateInstance(CLSID_FilterGraph,
NULL,
CLSCTX_INPROC,
IID_IGraphBuilder,
(LPVOID *)&pGraphBuilder);
pGraphBuilder->QueryInterface(IID_IMediaControl,
(LPVOID *)&pMediaControl);
pMediaControl->RenderFile(FILENAME);

pGraphBuilder->QueryInterface(IID_IBasicVideo,
(LPVOID *)&pBasicVideo);

pMediaControl->Run();
// The image will be saved when OK is clicked
MessageBox(NULL,
"Grab Image",
"Grab",
MB_OK);

// Must Pause before using GetCurrentImage
pMediaControl->Pause();
// get width and height
long height, width;
pBasicVideo->get_VideoHeight(&height);
pBasicVideo->get_VideoWidth(&width);
long bufSize;
long *imgData;
HRESULT hr;
/*
The second value is NULL to resolve required buffer size.
The required buffer size will be returned in variable "bufSize".
*/
hr = pBasicVideo->GetCurrentImage(&bufSize, NULL);
if (FAILED(hr)) {
printf("GetCurrentImage failed\n");
return 1;
}
if (bufSize < 1) {
printf("failed to get data size\n");
return 1;
}
imgData = (long *)malloc(bufSize);
// The data will be in DIB format
pBasicVideo->GetCurrentImage(&bufSize, imgData);

// save DIB file as Bitmap.
// This sample saves image as bitmap to help
// understanding the sample.
HANDLE fh;
BITMAPFILEHEADER bmphdr;
BITMAPINFOHEADER bmpinfo;
DWORD nWritten;
memset(&bmphdr, 0, sizeof(bmphdr));
memset(&bmpinfo, 0, sizeof(bmpinfo));
bmphdr.bfType = ('M' << 8) | 'B';
bmphdr.bfSize = sizeof(bmphdr) + sizeof(bmpinfo) + bufSize;
bmphdr.bfOffBits = sizeof(bmphdr) + sizeof(bmpinfo);
bmpinfo.biSize = sizeof(bmpinfo);
bmpinfo.biWidth = width;
bmpinfo.biHeight = height;
bmpinfo.biPlanes = 1;
bmpinfo.biBitCount = 32;
fh = CreateFile("result.bmp",
GENERIC_WRITE, 0, NULL,
CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
WriteFile(fh, &bmphdr, sizeof(bmphdr), &nWritten, NULL);
WriteFile(fh, &bmpinfo, sizeof(bmpinfo), &nWritten, NULL);
WriteFile(fh, imgData, bufSize, &nWritten, NULL);
CloseHandle(fh);

free(imgData);
// Release resource
pBasicVideo->Release();

pMediaControl->Release();
pGraphBuilder->Release();
CoUninitialize();
return 0;
}

条款28: 划分全局名字空间

全局空间最大的问题在于它本身仅有一个。在大的软件项目中，经常会有不少人把他们定义的名字都放在这个单一的空间中，从而不可避免地导致名字冲突。例如，假设library1.h定义了一些常量，其中包括：

const double lib_version = 1.204;

类似的，library2.h也定义了：

const int lib_version = 3;

很显然，如果某个程序想同时包含library1.h和library2.h就会有问题。对于这类问题，你除了嘴里骂几句，或给作者发报复性邮件，或自己编辑头文件来消除名字冲突外，也没其它什么办法。

但是，作为程序员，你可以尽力使自己写的程序库不给别人带来这些问题。例如，可以预先想一些不大可能造成冲突的某种前缀，加在每个全局符号前。当然得承认，这样组合起来的标识符看起来不是那么令人舒服。

另一个比较好的方法是使用c++ namespace。namespace本质上和使用前缀的方法一样，只不过避免了别人总是看到前缀而已。所以，不要这么做：

const double sdmbook_version = 2.0;      // 在这个程序库中,
                                         // 每个符号以"sdm"开头
class sdmhandle { ... };                

sdmhandle& sdmgethandle();             // 为什么函数要这样声明？
                                       // 参见条款47

而要这么做：

namespace sdm {
  const double book_version = 2.0;
  class handle { ... };
  handle& gethandle();
}

用户于是可以通过三种方法来访问这一名字空间里的符号：将名字空间中的所有符号全部引入到某一用户空间；将部分符号引入到某一用户空间；或通过修饰符显式地一次性使用某个符号：

void f1()
{
  using namespace sdm;           // 使得sdm中的所有符号不用加
                                 // 修饰符就可以使用

  cout << book_version;          // 解释为sdm::book_version
  ...

  handle h = gethandle();        // handle解释为sdm::handle,
                                 // gethandle解释为sdm::gethandle
  ...                           

}

void f2()
{
  using sdm::book_version;        // 使得仅book_version不用加
                                 // 修饰符就可以使用

  cout << book_version;           // 解释为
                                  // sdm::book_version
  ...

  handle h = gethandle();         // 错误! handle和gethandle
                                  // 都没有引入到本空间
  ...                            

}

void f3()
{
  cout << sdm::book_version;      // 使得book_version
                                  // 在本语句有效
  ...                            

  double d = book_version;        // 错误! book_version
                                  // 不在本空间

  handle h = gethandle();         // 错误! handle和gethandle
                                  // 都没有引入到本空间
  ...                           

}

（有些名字空间没有名字。这种没命名的名字空间一般用于限制名字空间内部元素的可见性。详见条款m31。）

名字空间带来的最大的好处之一在于：潜在的二义不会造成错误（参见条款26）。所以，从多个不同的名字空间引入同一个符号名不会造成冲突（假如确实真的从不使用这个符号的话）。例如，除了名字空间sdm外，假如还要用到下面这个名字空间：

namespace acmewindowsystem {

  ...

  typedef int handle;

  ...

}

只要不引用符号handle，使用sdm和acmewindowsystem时就不会有冲突。假如真的要引用，可以明确地指明是哪个名字空间的handle：

void f()
{
  using namespace sdm;                 // 引入sdm里的所有符号
  using namespace acmewindowsystem;    // 引入acme里的所有符号

  ...                                  // 自由地引用sdm
                                       // 和acme里除handle之外
                                       // 的其它符号

  handle h;                            // 错误! 哪个handle?

  sdm::handle h1;                      // 正确, 没有二义

  acmewindowsystem::handle h2;         // 也没有二义

  ...

}

假如用常规的基于头文件的方法来做，只是简单地包含sdm.h和acme.h，这样的话，由于handle有多个定义，编译将不能通过。

名字空间的概念加入到c++标准的时间相对较晚，所以有些人会认为它不太重要，可有可无。但这种想法是错误的，因为c++标准库（参见条款49）里几乎所有的东西都存在于名字空间std之中。这可能令你不以为然，但它却以一种直接的方式影响到你：这就是为什么c++提供了那些看起来很有趣的、没有扩展名的头文件，如<iostream>, <string>等。详细介绍参见条款49。

由于名字空间的概念引入的时间相对较晚，有些编译器可能不支持。就算是这样，那也没理由污染全局名字空间，因为可以用struct来近似实现namespace。可以这样做：先创建一个结构用以保存全局符号名，然后将这些全局符号名作为静态成员放入结构中：

// 用于模拟名字空间的一个结构的定义
struct sdm {
  static const double book_version;
  class handle { ... };
  static handle& gethandle();
};

const double sdm::book_version = 2.0;      // 静态成员的定义

现在，如果有人想访问这些全局符号名，只用简单地在它们前面加上结构名作为前缀：

void f()
{
  cout << sdm::book_version;

  ...

  sdm::handle h = sdm::gethandle();

  ...
}

但是，如果全局范围内实际上没有名字冲突，用户就会觉得加修饰符麻烦而多余。幸运的是，还是有办法来让用户选择使用它们或忽略它们。

对于类型名，可以用类型定义（typedef）来显式地去掉空间引用。例如，假设结构s（模拟的名字空间）内有个类型名t，可以这样用typedef来使得t成为s::t的同义词：

typedef sdm::handle handle;

对于结构中的每个（静态）对象x，可以提供一个（全局）引用x，并初始化为s::x：

const double& book_version = sdm::book_version;

老实说，如果读了条款47，你就会不喜欢定义一个象book_version这样的非局部静态对象。（你就会用条款47中所介绍的函数来取代这样的对象）

处理函数的方法和处理对象一样，但要注意，即使定义函数的引用是合法的，但代码的维护者会更喜欢你使用函数指针：

sdm::handle& (* const gethandle)() =      // gethandle是指向sdm::gethandle
  sdm::gethandle;                         // 的const 指针 (见条款21)

注意gethandle是一个常指针。因为你当然不想让你的用户将它指向别的什么东西，而不是sdm::gethandle，对不对？

（如果真想知道怎么定义一个函数的引用，看看下面：

sdm::handle& (&gethandle)() =      // gethandle是指向
  sdm::gethandle;                  // sdm::gethandle的引用

我个人认为这样的做法也很好，但你可能以前从没见到过。除了初始化的方式外，函数的引用和函数的常指针在行为上完全相同，只是函数指针更易于理解。）

有了上面的类型定义和引用，那些不会遭遇全局名字冲突的用户就会使用没有修饰符的类型和对象名；相反，那些有全局名字冲突的用户就会忽略类型和引用的定义，代之以带修饰符的符号名。还要注意的是，不是所有用户都想使用这种简写名，所以要把类型定义和引用放在一个单独的头文件中，不要把它和（模拟namespace的）结构的定义混在一起。

struct是namespace的很好的近似，但实际上还是相差很远。它在很多方面很欠缺，其中很明显的一点是对运算符的处理。如果运算符被定义为结构的静态成员，它就只能通过函数调用来使用，而不能象常规的运算符所设计的那样，可以通过自然的中缀语法来使用：

// 定义一个模拟名字空间的结构，结构内部包含widgets的类型
// 和函数。widgets对象支持operator+进行加法运算
struct widgets {
  class widget { ... };

  // 参见条款21：为什么返回const
  static const widget operator+(const widget& lhs,
                                const widget& rhs);

  ...

};

// 为上面所述的widge和operator+
// 建立全局（无修饰符的）名称

typedef widgets::widget widget;

const widget (* const operator+)(const widget&,        // 错误!
                                 const widget&);       // operator+不能是指针名
 

widget w1, w2, sum;

sum = w1 + w2;                           // 错误! 本空间没有声明
                                         // 参数为widgets 的operator+

sum = widgets::operator+(w1, w2);        // 合法, 但不是
                                         // "自然"的语法

正因为这些限制，所以一旦编译器支持，就要尽早使用真正的名字空间。