CSimpleStringT::ReleaseBuffer
GetBuffer配置之緩衝區的釋放控制項。
void ReleaseBuffer(
int nNewLength = -1
);
參數
- nNewLength
未繫結的新字串的長度 (以字元為單位), null 結束字元。如果字串為 null 結尾, -1 預設值設定 CSimpleStringT 大小為字串的目前長度。
備註
呼叫這個方法會重新配置或釋放字串物件的緩衝區。如果您知道在緩衝區的字串為 null 結尾,可以省略 nNewLength 引數。如果字串不是以 null 結尾,請使用 nNewLength 指定其長度。GetBuffer 傳回的位址會在呼叫後是無效的。 ReleaseBuffer 或其他 CSimpleStringT 作業。
範例
以下範例將說明 CSimpleStringT::ReleaseBuffer 的用法。
const int bufferSize = 1024;
CSimpleString s(_T("abc"), pMgr);
LPTSTR p = s.GetBuffer(bufferSize);
_tcscpy_s(p, bufferSize , _T("abc")); // use the buffer directly
ASSERT(s.GetLength() == 3); // String length = 3
s.ReleaseBuffer(); // Surplus memory released, p is now invalid.
ASSERT(s.GetLength() == 3); // Length still 3
需求
Header: atlsimpstr.h