Udostępnij za pośrednictwem


CSimpleStringT::ReleaseBuffer

Sterowanie buforu przydzielanego przez GetBuffer.

void ReleaseBuffer(
   int nNewLength = -1
);

Parametry

  • nNewLength
    Nowe długość ciągu w znaków, nie licząc null terminator.Jeśli ciąg jest null, zakończone, ustawia wartość domyślną-1 CSimpleStringT rozmiar bieżącego długość ciągu.

Uwagi

Wywołanie tej metody do ponownego przydzielenia lub zwolnić buforu obiektu string.Jeśli wiadomo, że w buforze ciągu jest zakończona znakiem null, można pominąć nNewLength argumentu.Jeśli ciąg nie jest null zakończone, użyj nNewLength do określenia jej długości.Adres zwrócony przez GetBuffer jest nieprawidłowy, po wywołaniu ReleaseBuffer lub innych CSimpleStringT operacji.

Przykład

Poniższy przykład ilustruje użycie 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

Wymagania

Nagłówek: atlsimpstr.h

Zobacz też

Informacje

Klasa CSimpleStringT