Compartilhar via


CStringT::Left

Extrai os caracteres mais à esquerda de nCount de esse objeto de CStringT e retorna uma cópia da subcadeia de caracteres extraído.

CStringT Left(
   int nCount
) const;

Parâmetros

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

Valor de retorno

Um objeto de CStringT que contém uma cópia do intervalo especificado de caracteres.Observe que o objeto retornado de CStringT pode ser vazia.

Comentários

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

Para conjuntos de caracteres de multibyte (MBCS), nCount refere-se a cada caractere de 8 bits; ou seja, uma ligação e um byte final em um caractere de multibyte são contados como dois caracteres.

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