CStringT::CollateNoCase
汎用テキスト関数 _tcscoll を使用して、2 つの文字列を比較します。
int CollateNoCase(
PCXSTR psz
) const throw();
パラメーター
- psz
比較対象の文字列。
戻り値
文字列が一致した場合は ( CStringT のこのオブジェクトが psz よりも大きい場合 CStringT でこのオブジェクトよりも小さい場合が psz 場合は無視)、" < 0 (大文字を無視します)、または > 0 (大文字を無視します)。
解説
汎用テキスト関数 _tcscoll は TCHAR.H で定義されています。この関数は、コンパイル時に定義された文字セットに応じて、stricoll、wcsicoll、または _mbsicoll に割り当てられます。各関数は、現在使用中のコード ページに従って文字列の大文字小文字を区別しない比較を実行します。詳細については、「strcoll、wcscoll、_mbscoll、_strcoll_l、_wcscoll_l、_mbscoll_l」を参照してください。
使用例
// 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);
必要条件
ヘッダー: cstringt.h