LPTSTR GetBufferSetLength ( int nNewLength );
lançar ( CMemoryException );
Valor de retorno
Um LPTSTR ponteiro ao buffer de caracteres (terminação nula) do objeto.
Parâmetros
nNewLength
O tamanho exato do buffer de caracteres CString em caracteres.
Observações
Retorna um ponteiro para o buffer de caractere interno para o objeto de CString , truncando ou aumentando o seu comprimento se necessário para coincidir exatamente com o comprimento especificado em nNewLength. O ponteiro retornado LPTSTR não é const e, portanto, permite a modificação direta do conteúdo de CString.
Se você usar o ponteiro retornado por GetBuffer para alterar o conteúdo de Cadeia de caracteres, você deve chamar ReleaseBuffer antes de usar qualquer outro funções de membro CString.
O endereço retornado por GetBufferSetLength pode não ser válido após a chamada para ReleaseBuffer pois adicionais CString operações podem causar o buffer de CString ser realocado. A reserva não ser reatribuída se você não Alterar o comprimento de CString.
A memória de buffer será liberada automaticamente quando o objeto de CString é destruído.
Observe que se você controla o Cadeia de caracteres comprimento você mesmo, você deve não acrescentar o caractere nulo final. Você deve, no entanto, especificar o comprimento de Cadeia de caracteres final quando você liberar o buffer com ReleaseBuffer. Se você acrescentar um caractere nulo final quando você chamar ReleaseBuffer, você deve passar – 1 (o padrão) para o comprimento. ReleaseBuffer executará um strlen no buffer para determinar seu comprimento.
Para obter mais informações sobre a contagem de referência, consulte os seguintes artigos:
Visão geral de CString |nbsp; Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CString::GetBuffer, CString::ReleaseBuffer