LPTSTR GetBufferSetLength ( Int nNewLength );
werfen ( CMemoryException );
Rückgabewert
Ein LPTSTR -Zeiger auf das Objekt (Null) endende Puffer.
Parameter
nNewLength
Die genaue Größe des Puffers Charakter CString in Zeichen.
Bemerkungen
Gibt einen Zeiger auf den internen Zeichenpuffer für die CString -Objekt, kürzen oder seine Länge wachsen, wenn notwendig, die im nNewLengthangegebene Länge genau übereinstimmen. Der zurückgegebene Zeiger LPTSTR nicht const und ermöglicht so die direkte Änderung der CString -Inhalt.
Wenn Sie den von GetBuffer zurückgegebenen Zeiger verwenden, um Inhalt der Zeichenfolge zu ändern, müssen Sie ReleaseBuffer aufrufen, bevor Sie andere CString -Memberfunktionen verwenden.
Die von GetBufferSetLength zurückgegebene Adresse möglicherweise nicht gültig nach dem Aufruf von ReleaseBuffer da zusätzliche CString -Operationen verursachen den CString -Puffer neu reserviert werden. Der Puffer wird nicht zugewiesen werden, wenn Sie nicht die Länge der CString ändern.
Der Pufferspeicher wird automatisch freigegeben werden, wenn das CString -Objekt zerstört wird.
Beachten Sie, dass wenn Sie Nachverfolgen der Länge die Zeichenfolge selbst, sollte Sie nicht das abschließende Nullzeichen angefügt. Sie müssen jedoch die endgültige Zeichenfolgenlänge angeben, bei der Freigabe des Puffers mit ReleaseBuffer. Wenn Sie ein abschließendes Nullzeichen beim ReleaseBufferaufrufen anfügen, sollten Sie – 1 (die Standardeinstellung) für die Länge übergeben. ReleaseBuffer führt ein Strlen im Puffer zu bestimmen, ihre Länge.
Weitere Informationen zur Verweiszählung finden Sie in die folgenden Artikeln:
Übersicht über die CString |nbsp; Member der Klasse | Hierarchiediagramm
Siehe auch&Nbsp;CString::GetBuffer, CString::ReleaseBuffer