CStringT::CollateNoCase
Compara duas seqüências de caracteres usando a função de texto genérica _tcscoll.
int CollateNoCase(
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 (ignorando o caso), < 0 se esteCStringTo objeto é menor que psz(ignorando o caso), ou > 0 se este CStringTobjeto for maior que psz (ignorando o caso).
Comentários
A função de texto genérica _tcscoll, que é definido em TCHAR.H, mapeia para um stricoll, wcsicoll, ou _mbsicoll, dependendo do conjunto de caractere que é definido no momento da compilar. Cada função executa uma comparação não diferencia maiúsculas de minúsculas de cadeias de caracteres, de acordo com para 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;
CAtlString str1 = _T("Co-Op");
CAtlString str2 = _T("con");
int n;
// Collation uses language rules, such as ignoring dashes.
// NoCase version ignores case.
n = str1.CollateNoCase(str2);
ASSERT(n < 0);
// Comparison is a strict ASCII comparison with no language rules
// but still ignores case in NoCase version.
n = str1.CompareNoCase(str2);
ASSERT(n < 0);
Requisitos
Cabeçalho: cstringt.h