Этот метод возвращает указатель на внутренний символьный буфер объекта CString, усекая или наращивая его длину, в случае необходимости, до точного соответствия длине, указанной вnNewLength. Возвращенный указатель LPTSTR - не константа и таким образом позволяет прямую модификацию содержания CString.
LPTSTR GetBufferSetLength(
int nNewLength );
nNewLength
Определяет точный размер буфера символа CString в символах.
Указатель LPTSTR на внутренний символьный буфер объекта с нулевым символом в конце.
Если Вы используете указатель, возвращенный GetBuffer, чтобы изменить строковое содержание, Вы должны вызвать ReleaseBuffer перед использованием любых других CString методов.
Адрес, возвращенный GetBufferSetLength может не быть правилен после обращения к ReleaseBuffer, так как дополнительные операции CString могут заставить буфер CString перераспределиться. Если Вы не изменяете длину CString, буфер не будет перераспределен.
Буферная память освободится автоматически, когда объект CString будет разрушен.
Обратите внимание, что, если Вы следите за длиной строки самостоятельно, Вы не должны добавилят в конец нуль-терминатор. Вы должны, однако, определить конечную строковую длину, когда Вы выпускаете буфер с помощью ReleaseBuffer. Если Вы действительно добавляете в конец закончившийся нулевой символ, Вы должны передать длину-1 в ReleaseBuffer, который выполнит функцию tcslen для буфера, чтобы определить его длину.
CString str;
LPTSTR pstr = str.GetBufferSetLength(3);
pstr[0] = 'I';
pstr[1] = 'c';
pstr[2] = 'e';
// Нет необходимости в перемещении нуля или в запросе к ReleaseBuffer
()
// потому что GetBufferSetLength () устанавливают это для нас!
str + = _T (" хоккей является лучшим спортом! ");