CStringT::CollateNoCase
Compare deux chaînes à l'aide de la fonction _tcscollde texte générique.
int CollateNoCase(
PCXSTR psz
) const throw();
Paramètres
- psz
l'autre chaîne utilisée pour la comparaison.
Valeur de retour
Zéro si les chaînes sont identiques (en ignorant le cas), < 0 si cet objet d' CStringT est moins qu' psz (en ignorant le cas), ou > 0 si cet objet d' CStringT est supérieur psz (en ignorant le cas).
Notes
La fonction _tcscollde texte générique, qui est définie dans TCHAR.H, mappe à stricoll, à wcsicoll, ou à _mbsicoll, selon le jeu de caractères qui est défini au moment de la compilation. Chaque fonction effectue une comparaison ne respectant pas la casse des chaînes, d'après la page de code en cours de utilisation. Pour plus d'informations, consultez strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l.
Exemple
// 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);
Configuration requise
Header: cstringt.h