CString::GetBuffer、ReleaseBuffer函数

注意：1、CString对象内部的最后保留了'\0'字符，但是必须通过Getbuffer返回其指针后访问它才不会发生异常，如果用GetAt(GetLength())访问就会发生异常.

2、GetBuffer函数与GetbufferSetLength中的参数如果大于字符串的实际长度，则自动开辟新增加的长度。当调用ReleaseBuf函数后，则新增加的缓冲区如果未被存放内容那么多于的内存就会被释放。如果参数小于字符串的实际长度，并且大于等于0，则利用返回的指针访问不会发生异常，并且如果未做任何修改操作，那么当调用ReleaseBuf函数后，还是保持原来的字符串内容部变。如果小于0则会发生异常。

CString::GetBuffer

LPTSTR GetBuffer( int nMinBufLength );
  throw( CMemoryException );

返回值：一个指向对象的（以空字符结尾的）字符缓冲区的LPTSTR指针。

参数：

nMinBufLength

字符缓冲区的以字符数表示的最小容量。这个值不包括一个结尾的空字符的空间。

说明：
此成员函数返回一个指向CString对象的内部字符缓冲区的指针。返回的LPTSTR不是const，因此可以允许直接修改CString的内容。
如果你使用由GetBuffer返回的指针来改变字符串的内容，你必须在使用其它的CString成员函数之前调用ReleaseBuffer函数。
在调用ReleaseBuffer之后，由GetBuffer返回的地址也许就无效了，因为其它的CString操作可能会导致CString缓冲区被重新分配。如果你没有改变此CString的长度，则缓冲区不会被重新分配。
当此CString对象被销毁时，其缓冲区内存将被自动释放。
注意，如果你自己知道字符串的长度，则你不应该添加结尾的空字符。但是，当你用ReleaseBuffer来释放该缓冲区时，你必须指定最后的字符串长度。如果你添加了结尾的空字符，你应该给ReleaseBuffer的长度参数传递-1，ReleaseBuffer将对该缓冲区执行strlen来确定它的长度。

示例：下面的例子说明了如何用CString::GetBuffer。
// CString::GetBuffer例子
CString s( "abcd" );
#ifdef _DEBUG
   afxDump << "CString s" << s << "\n";
#endif
LPTSTR p = s.GetBuffer( 10 );
strcpy( p, "Hello" ); // 直接访问CString对象。
s.ReleaseBuffer( );
#ifdef _DEBUG
   afxDump << "CString s " << s << "\n";
#endif

 

CString::ReleaseBuffer

void ReleaseBuffer( int nNewLength = -1 );

参数：

nNewLength

此字符串的以字符数表示的新长度，不计算结尾的空字符。如果这个字符串是以空字符结尾的，则参数的缺省值－1将把CString的大小设置为字符串的当前长度。

说明：
使用ReleaseBuffer来结束对由GetBuffer分配的缓冲区的使用。如果你知道缓冲区中的字符串是以空字符结尾的，则可以省略nNewLength参数。如果字符串不是以空字符结尾的，则可以使用nNewLength指定字符串的长度。在调用ReleaseBuffer或其它CString操作之后，由GetBuffer返回的地址是无效的。

示例：下面的例子说明了如何使用CString::ReleaseBuffer。
// CString::ReleaseBuffer示例：
CString s;s = "abc";
LPTSTR p = s.GetBuffer( 1024 );
strcpy(p, "abc"); // 直接使用该缓冲区
ASSERT( s.GetLength() == 3 ); // 字符串长度 = 3
s.ReleaseBuffer(); // 释放多余的内存，现在p无效。
ASSERT( s.GetLength() == 3 ); // 长度仍然是3

CString::GetBufferSetLength

LPTSTR GetBufferSetLength( int nNewLength );
  throw( CMemoryException );

返回值：
返回一个指向对象的（以空字符结尾的）字符缓冲区的LPTSTR指针。

参数：

nNewLength

此CString字符缓冲区的以字符数表示的精确容量。

说明：
此成员函数返回一个指向CString对象的内部字符缓冲区的指针，如果需要的话，切断或增长缓冲区的长度以精确匹配由nNewLength指定的长度。返回的LPTSTR不是const，因此可以允许直接修改CString的内容。
如果你使用由GetBuffer返回的指针来改变字符串的内容，你必须在使用其它的CString成员函数之前调用ReleaseBuffer函数。
在调用ReleaseBuffer之后，由GetBuffer返回的地址也许就无效了，因为其它的CString操作可能会导致CString缓冲区被重新分配。如果你没有改变此CString的长度，则缓冲区不会被重新分配。
当此CString对象被销毁时，其缓冲区内存将被自动释放。
注意，如果你自己知道字符串的长度，则你不应该添加结尾的空字符。但是，当你用ReleaseBuffer来释放该缓冲区时，你必须指定最后的字符串长度。如果你添加了结尾的空字符，你应该给ReleaseBuffer的长度参数传递-1，ReleaseBuffer将对该缓冲区执行strlen来确定它的长度。
有关引用计数的更多信息，参见下面的文章：

·	“Win 32 SDK程序员参考”中的“通过引用计数来管理对象的生命周期”。
·	“Win 32 SDK程序员参考”中的“实现引用计数”。
·	“Win 32 SDK程序员参考”中的“管理引用计数的规则”。