Compartilhar via


CSimpleStringT::ReleaseBuffer

Controle de versões do buffer alocado por GetBuffer.

void ReleaseBuffer(
   int nNewLength = -1
);

Parâmetros

  • nNewLength
    O novo comprimento da seqüência de caracteres em caracteres, não contando um terminador nulo.Se a seqüência de caracteres for nulo encerrada, o valor padrão de-1 define o CSimpleStringT dimensionar para o comprimento da seqüência de caracteres corrente.

Comentários

telefonar Esse método para realocar ou liberar o buffer do objeto de seqüência de caracteres.Se você sabe que é a seqüência de caracteres no buffer nulo finalizado, você pode omitir o nNewLength argumento. Se sua cadeia de caracteres não nula finalizada, use nNewLength Para especificar seu comprimento. O endereço retornado por GetBuffer é inválido após a telefonar para ReleaseBuffer ou qualquer Outros CSimpleStringT operação.

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 CSimpleStringT

Outros recursos

CSimpleStringT membros