Compartilhar via


CStringT::Left

Extrai os caracteres nCount do lado extremo esquerdo desse objeto CStringT e retorna uma cópia da subcadeia de caracteres extraída.

CStringT Left(
   int nCount
) const;

Parâmetros

  • nCount
    O número de caracteres para extrair desse objeto CStringT.

Valor de retorno

Um objeto CStringT que contém uma cópia do intervalo especificado de caracteres. O objeto CStringT retornado pode estar vazio.

Comentários

Se nCount exceder o comprimento da cadeia de caracteres, a cadeia de caracteres inteira será extraída. Left é semelhante à função Left básica.

Para conjuntos de caracteres de vários bytes (MBCS), nCount trata cada sequência de 8 bits como um caractere para que nCount retorne o número de caracteres de vários bytes multiplicados por dois.

Exemplo

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

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

Requisitos

Cabeçalho: cstringt.h

Consulte também

Referência

Classe de CStringT