CString的GetBuffer用法

一．函数原型

CString::GetBuffer

LPTSTR GetBuffer( int nMinBufLength );

throw( CMemoryException );

Return Value

An LPTSTR pointer to the object’s (null-terminated) character buffer.

Parameters

nMinBufLength

The minimum size of the character buffer in characters. This value does not include space for a null terminator.

Remarks

Returns a pointer to the internal character buffer for the CString object. The returned LPTSTR is not const and thus allows direct modification of CString contents.

If you use the pointer returned by GetBuffer to change the string contents, you must call ReleaseBuffer before using any other CString member functions.

二．函数作用及使用范围

对一个CString变量，你可以使用的唯一合法转换符是LPCTSTR，直接转换成非常量指针（LPTSTR-[const] char*）是错误的。正确的得到一个指向缓冲区的非常量指针的方法是调用GetBuffer()方法。

GetBuffer()主要作用是将字符串的缓冲区长度锁定，releaseBuffer则是解除锁定，使得CString对象在以后的代码中继续可以实现长度自适应增长的功能。

CString ::GetBuffer有两个重载版本:

LPTSTR GetBuffer( );LPTSTR GetBuffer(int nMinBufferLength);

在第二个版本中，当设定的长度小于原字符串长度时，nMinBufLength = nOldLen，该参数会被忽

略，不分配内存，指向原CString；当设定的长度大于原字符串本身的长度时就要重新分配（reallocate）一块比较大的空间出来。而调用第一个版本时，应如通过传入0来调用第二个版本一样。

是否需要在GetBufer后面调用ReleaseBuffer()，是根据你的后面的程序是否需要继续使用该字符串变量，并且是否动态改变其长度而定的。如果你GetBuffer以后程序自函数就退出，局部变量都不存在了，调用不调用ReleaseBuffer没什么意义了。

最典型的应用就是读取文件：

CFile file;

// FILE_NAME 为实现定义好的文件名称

if(file.Open(FILE_NAME,CFile::modeRead))

{

       CString szContent;

       int nFileLength = file.GetLength();

       file.Read(szContent.GetBuffer(nFileLength),nFileLength);

       szContent.ReleaseBuffer();

       // 取得文件內容放在szContent中，我们之后可以对其操作

}

三．测试

以下就CString::GetBuffer，做简单测试：

测试1：

// example for CString::GetBuffer

 

#include <stdio.h>

#include <afx.h>

 

void main(void)

{    

       CString s( "abcd" );

       printf("(1)before GetBuffer:/n");

       printf("CString s.length=%d/n",s.GetLength());

       printf("CString s=%s/n",s);

      

       LPTSTR p = s.GetBuffer( 2 );

      

       printf("(2)after GetBuffer and before ReleaseBuffer:/n");

       printf("LPTSTR p=%s/n",p);    

       printf("p.length=%d/n",strlen(p));

printf("CString s=%s/n",s);      

       printf("CString s.length=%d/n",s.GetLength());

      

 

       s.ReleaseBuffer( );

       printf("(3)after ReleaseBuffer:/n");

       printf("LPTSTR p=%s/n",p);    

       printf("p.length=%d/n",strlen(p));

printf("CString s=%s/n",s);

       printf("CString s.length=%d/n",s.GetLength());    

}

测试结果1：

(1)before GetBuffer:

CString s.length=4

CString s=abcd

(2)after GetBuffer and before ReleaseBuffer:

LPTSTR p=abcd

p.length=4

CString s=abcd

CString s.length=4

(3)after ReleaseBuffer:

LPTSTR p=abcd

p.length=4

CString s=abcd

CString s.length=4

Press any key to continue

测试2：

将LPTSTR p = s.GetBuffer( 2 ); 修改为：LPTSTR p = s.GetBuffer( 10 );

测试结果同1。

测试3：

在测试二的LPTSTR p = s.GetBuffer( 10 );后添加  p[5]='f';

测试结果同1。

测试4：

将测试三的p[5]='f';修改为p[4]='e';

测试结果4：

(1)before GetBuffer:

CString s.length=4

CString s=abcd

(2)after GetBuffer and before ReleaseBuffer:

LPTSTR p=abcde屯屯?

p.length=10

CString s=abcde屯屯?

CString s.length=4

(3)after ReleaseBuffer:

LPTSTR p=abcde屯屯?

p.length=10

CString s=abcde屯屯?

CString s.length=10

Press any key to continue

很显然(2)after GetBuffer and before ReleaseBuffer:中 CString s.length=4结果有问题。

注意：以上测试是在_MBCS环境下，如果换成_UNICODE则结果有可能不同。

参考：

《CString GetBuffer()》

http://blog.csdn.net/hbyh/archive/2007/09/15/1786574.aspx

《CString之GetBuffer问题》

http://game.tongji.net/thread-379834-1-1.html

《CString的GetBuffer》

http://www.programfan.com/blog/article.asp?id=40755

《CString GetBuffer() and ReleaseBuffer()》

http://blog.csdn.net/guanchanghui/archive/2006/09/13/1217096.aspx

《CString::GetBuffer()与CString::ReleaseBuffer到底有什么用？》

http://topic.csdn.net/t/20060313/22/4612156.html