Compartilhar via


CStringT::Collate

Compara duas seqüências de caracteres usando a função de texto genérica _tcscoll.

int Collate(
   PCXSTR psz
) const throw();

Parâmetros

  • psz
    A Outros seqüência usada para comparação.

Valor de retorno

Zero se as seqüências são idênticas, < 0 se esteCStringT o objeto é menor que psz, ou > 0 se este CStringT objeto for maior que psz.

Comentários

A função de texto genérica _tcscoll, que é definido em TCHAR.H, mapeia para um strcoll, wcscoll, ou _mbscoll, dependendo do conjunto de caractere que é definido no momento da compilar. Cada função executa uma comparação diferenciando diferenciar maiúsculas de minúsculas das seqüências de acordo com a página de código atualmente em uso.Para obter mais informações, consulte strcoll wcscoll _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l.

Exemplo

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
_tsetlocale(LC_ALL, _T("german"));

CAtlString str1 = _T("strasse");
CAtlString str2 = _T("strae");

int n;

n = str1.Collate(str2);
ASSERT(n == 0);

// Comparison is a strict ASCII comparison with no language rules.
n = str1.Compare(str2);
ASSERT(n < 0);   

Requisitos

Cabeçalho: cstringt.h

Consulte também

Referência

Classe CStringT

Outros recursos

CStringT membros