Compartilhar via


CStringT::Compare

 

Publicado: abril de 2016

Compara duas cadeias de caracteres (diferencia maiúsculas de minúsculas).

Sintaxe

int Compare(
   PCXSTR psz
) const;

Parâmetros

  • psz
    Outra cadeia de caracteres usada para comparação.

Valor de retorno

Zero se as cadeias de caracteres são idênticas, < 0 se este objeto de CStringT é menor que psz, ou > 0 se este objeto de CStringT é maior do que psz.

Comentários

A função _tcscmpde genérico- texto, que é definido em TCHAR.H, mapeia a strcmp, a wcscmp, ou a _mbscmp, dependendo do conjunto de caracteres que é definido em tempo de compilação. Cada função executa uma comparação com diferenciação de maiúsculas e minúsculas de cadeias de caracteres e não é afetado pela localidade. Para mais informações, consulte strcmp, wcscmp, _mbscmp.

Se a cadeia de caracteres contém inserido nulos, para fins de comparação que a cadeia de caracteres é considerada como truncada no primeiro caractere nulo inserido.

Exemplo

O exemplo a seguir demonstra o uso de CStringT::Compare.

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

CAtlString s1(_T("abc"));
CAtlString s2(_T("abd"));
ASSERT(s1.Compare(s2) < 0);    // Compare with another CAtlString.
ASSERT(s1.Compare(_T("abe")) < 0); // Compare with LPTSTR string.   

Requisitos

Cabeçalho: cstringt.h

Consulte também

Classe de CStringT