Поделиться через


CSimpleStringT::ReleaseBuffer

Управление выпусков буфера выбранного GetBuffer.

void ReleaseBuffer(
   int nNewLength = -1
);

Параметры

  • nNewLength
    Новая длина строки (в символах), не учитываются нулевой завершающий символ.Если строка завершенное null, по умолчанию используется значение -1 задает размер CSimpleStringT в текущую длину строки.

Заметки

Вызовите этот метод, чтобы reallocate или освободить буфер строковый объект.Если известно, что строка в буфере завершилась 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

См. также

Ссылки

Класс CSimpleStringT