Condividi tramite


CSimpleStringT::ReleaseBuffer

Controllo delle versioni del buffer allocato da GetBuffer.

void ReleaseBuffer(
   int nNewLength = -1
);

Parametri

  • nNewLength
    La lunghezza della nuova stringa i caratteri, non contante un terminatore null.Se la stringa è con terminazione null, il valore predefinito -1 imposta la dimensione CSimpleStringT alla lunghezza della stringa corrente.

Note

Chiamare questo metodo per ridistribuire o liberare il buffer dell'oggetto stringa.Se si è certi che la stringa nel buffer è con terminazione null, è possibile omettere l'argomento nNewLength.Se la stringa non è con terminazione null, utilizzare nNewLength per specificare la relativa lunghezza.L'indirizzo restituito da GetBuffer non è valido dopo la chiamata a ReleaseBuffer o qualsiasi altro tipo CSimpleStringT.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di 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

Requisiti

Header: atlsimpstr.h

Vedere anche

Riferimenti

Classe di CSimpleStringT