CString::GetBufferSetLength

LPTSTR GetBufferSetLength ( int nNewLength );
gettare ( CMemoryException );

Valore restituito

Un puntatore a LPTSTR a buffer di caratteri (a terminazione null) dell'oggetto.

Parametri

nNewLength

L'esatta dimensione del buffer carattere CString in caratteri.

Osservazioni

Restituisce un puntatore al buffer interno di carattere per l'oggetto CString , troncando o crescere la sua lunghezza se necessario corrispondere esattamente alla lunghezza specificata in nNewLength. Il puntatore restituito LPTSTR non sia const e quindi permette la modifica diretta del contenuto CString.

Se si utilizza il puntatore restituito dal metodo GetBuffer per modificare il contenuto della stringa, è necessario chiamare ReleaseBuffer prima di utilizzare qualsiasi altre funzioni di membro CString.

L'indirizzo restituito da GetBufferSetLength potrebbe non essere valida dopo la chiamata a ReleaseBuffer poiché operazioni aggiuntive CString possono causare il buffer CString possono essere riallocate. Il buffer non essere riassegnato se non si modifica la lunghezza della CString.

Il buffer di memoria verrà liberata automaticamente quando viene eliminata l'oggetto CString.

Si noti che, se tenere traccia della lunghezza della stringa te stesso, non è necessario aggiungere il carattere di terminazione null. È tuttavia necessario, specificare la lunghezza della stringa finale quando si rilascia il buffer con ReleaseBuffer. Se potete aggiungere un carattere di terminazione null quando si chiama ReleaseBuffer, si dovrebbe passare – 1 (impostazione predefinita) per la lunghezza. ReleaseBuffer suonerà un strlen il buffer per determinare la lunghezza.

Per ulteriori informazioni sul conteggio dei riferimenti, vedere i seguenti articoli:

CString panoramica |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CString::GetBuffer, CString::ReleaseBuffer

Index