CStringT::CollateNoCase
Compara duas cadeias de caracteres usando a função _tcscollde genérico- texto.
int CollateNoCase(
PCXSTR psz
) const throw();
Parâmetros
- psz
Outra cadeia de caracteres usada para comparação.
Valor de retorno
Zero se as cadeias de caracteres são idênticas (ignorando caso), < 0 se este objeto de CStringT é menor que psz (ignorando caso), ou > 0 se este objeto de CStringT é maior do que psz (ignorando caso).
Comentários
A função _tcscollde genérico- texto, que é definido em TCHAR.H, mapeia a stricoll, a wcsicoll, ou a _mbsicoll, dependendo do conjunto de caracteres que é definido em tempo de compilação. Cada função executa uma comparação que não diferencia maiúsculas de minúsculas de cadeias de caracteres, de acordo com a página de código atualmente em uso. Para 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