Compartilhar via


CSimpleStringT::ReleaseBuffer

Controle de versões do buffer atribuído por GetBuffer.

void ReleaseBuffer(
   int nNewLength = -1
);

Parâmetros

  • nNewLength
    O novo tamanho da cadeia de caracteres em caracteres, contando um terminador não nulo.Se a cadeia de caracteres é encerrado zero, o valor padrão -1 defina o tamanho de CSimpleStringT para o comprimento atual de cadeia de caracteres.

Comentários

Chamar esse método para realocar acima ou liberar o buffer de objeto de cadeia de caracteres.Se você souber que a cadeia de caracteres em buffer é encerrado zero, você pode omitir o argumento de nNewLength .Se a cadeia de caracteres não é encerrado zero, use nNewLength para especificar o comprimento.O endereço retornado por GetBuffer não é válida após a chamada a ReleaseBuffer ou qualquer outra operação de CSimpleStringT .

Exemplo

O exemplo a seguir demonstra o uso de 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

Requisitos

Cabeçalho: atlsimpstr.h

Consulte também

Referência

Classe de CSimpleStringT