CString::GetBufferSetLength

LPTSTR GetBufferSetLength ( int nNewLength );
бросить ( CMemoryException );

Возвращаемое значение

LPTSTR указатель на буфер символов (нулем) объекта.

Параметры

nNewLength

Точный размер буфера знаков CString в символах.

Примечания

Возвращает указатель на буфер внутренних символов для объекта CString , усечение или растущий его длина при необходимости точно соответствовать длины, указанной в nNewLength. Возвращенный указатель LPTSTR не const и таким образом позволяет прямого изменения содержимого CString.

Если вы используете указатель, возвращаемый GetBuffer для изменения содержимого строки, необходимо вызвать ReleaseBuffer перед использованием любых других функций-членов CString.

Адрес, возвращенный GetBufferSetLength не может быть действительным после вызова ReleaseBuffer поскольку дополнительные операции CString могут вызвать CString буфера перераспределить. Буфер не быть возложены, если не изменить длину CString.

Память буфера будет освобожден автоматически, когда объект CString уничтожается.

Обратите внимание, что если вы отслеживать длину строки себя, вы не должны добавить концевой нулевой символ. Необходимо однако, указать длину последней строки при освобождении буфер с ReleaseBuffer. Если добавить завершающий символ null при вызове ReleaseBuffer, вам необходимо пройти –1 (по умолчанию) для длины. ReleaseBuffer будет выполнять strlen буфер для определения его длины.

Для получения дополнительных сведений о подсчет ссылок обратитесь к следующим статьям:

Обзор CString |nbsp; Члены класса | Иерархическая схема

См. также CString::GetBuffer, CString::ReleaseBuffer

Index