Поделиться через


CStringT::Left

Извлекает nCount самых левых символов из этого объекта CStringT и возвращает копию извлеченной подстроки.

CStringT Left(
   int nCount
) const;

Параметры

  • nCount
    Число символов, извлекаемых из данного объекта CStringT.

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

Объект CStringT, содержащий копию указанного диапазона символов. Возвращенный объект CStringT может быть пустым.

Заметки

Если значение nCount превышает длину строки, извлекается вся строка. Функция Left аналогична функции Left в языке Basic.

Для многобайтовых кодировок (MBCS) значение nCount обрабатывает каждую 8-разрядную последовательность как один символ, поэтому значение nCount возвращает количество многобайтовых символов, умноженное на 2.

Пример

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;

CAtlString s(_T("abcdef"));
ASSERT(s.Left(2) == _T("ab"));   

Требования

Заголовок: cstringt.h

См. также

Ссылки

CStringT Class