c++ CString::GetBuffer()
2010-04-27 20:50
　　GetBuffer :
　　说明:MFC函数
　　所属类:CString ,CBookMark,CBaseAllocator
　　介绍,CString:GetBuffer;
　　
　　这个函数是 为一个CString对象重新获取其内部字符缓冲区的指针, 返回的LPTSTR为非const的,从而允许直接修改CString中的内容!如果nMinBufLength 比当前buffer大,那么就调用ReleaseBuffer函数去释放当前的Buffer,用一个被请求的大小去覆盖这个buffer重新设定计数器为0,如果在这之前你在这个buffer中调用了LockBuffer,那么你将失去你当前锁定的buffer
　　
　 　 如果你使用这个指向由GetBuffer所改变返回的字符串内容,那么在你使用CString其他CString方法之前你必须调用ReleaseBuffer。在调用ReleaseBuffer函数之后GetBuffer中的内容将无效(也就是销毁)
　　 当这个CString被销毁的时候,这个buffer所占用的内存将被自动释放
　　注意: 如果你知道了这个字符串的长度,你不可以直接添加NULL字符了事,当你使用ReleaseBuffer的时候你必须指定最后的字符串长度,如果你仅仅添加了一个NULL字符结束符给这个字符串,你应该给ReleaseBuffer传递一个-1 当这个函数结束的时候_tcslen 将决定这个buffer的长度
　　例子:
　　// example for CString::GetBuffer
　　CString s( "abcd" );//定义一个CString s并且初始化为abcd
　　#ifdef _DEBUG
　　afxDump << "CString s " << s << "\n";
　　#endif
　　LPTSTR p = s.GetBuffer( 10 );//定义一个指针指向LPTSTR并接受GetBuffer所返回的地址
　　lstrcpy( p, _T("Hello") ); // directly access CString buffer//使用Istrcpy将Hello]复制到该buffer中
　　s.ReleaseBuffer( );//释放buffer
　　#ifdef _DEBUG
　　afxDump << "CString s " << s << "\n";这时候s="Hello";
　　#endif
　　这是一个非常容易被用错的函数，主要可能是由于大家对它的功能不太了解。其实点破的话，也不是那么深奥。
　　 GetBuffer(int size)是用来返回一个你所指定的大小并可写内存的函数。它和被重载的操作符LPCTSTR还是有点本质区别的，LPCTSTR是直接返回一个只读内存的指针，而GetBuffer则是返回一个可以供调用者写入的内存，并且，你可以给定大小。下面是个简单的，但也是非常典型的例子：
　　int readFile(CString& str, const CString& strPathName)
　　{
　　FILE* fp = fopen(strPathName, "r"); // 打开文件
　　fseek(fp, 0, SEEK_END);
　　int nLen = ftell(fp); // 获得文件长度
　　fseek(fp, 0, SEEK_SET); // 重置读指针
　　char* psz = str.GetBuffer(nLen);
　　fread(psz, sizeof(char), nLen, fp); //读文件内容
　　str.ReleaseBuffer(); //千万不能缺少
　　fclose(fp);
　　}
　　上面的函数是GetBuffer函数最典型的用法了，其实它就相当于申请一块nLen大小的内存，只不过，这块内存是被引用在CString对象的内部而已，这是非常有效的一种用法，如果不直接用GetBuffer函数来申请的话，那么你必须用new操作符（或者malloc()函数）在CString的外部申请，然后再将申请的内存拷贝到CString对象中，显然这是一个非常冗余的操作，会使你函数的效率大大下降。
　　ReleaseBuffer函数是用来告诉CString对象，你的GetBuffer所引用的内存已经使用完毕，现在必须对它进行封口，否则CString将不会知道它现在所包含的字符串的长度，所以在使用完GetBuffer之后，必须立即调用ReleaseBuffer函数重置CString的内部属性，其实也就是头部信息。