CStringT::CollateNoCase
更新 : 2007 年 11 月
汎用テキスト関数 _tcscoll を使用して、2 つの文字列を比較します。
int CollateNoCase(
PCXSTR psz
) const throw();
パラメータ
- psz
比較対象の文字列。
戻り値
大文字小文字を区別せずに比較した結果、2 つの文字列が一致した場合は 0 を返します。CStringT オブジェクトが psz 未満の場合は 0 未満の値を返します。CStringT オブジェクトが psz を超える場合は 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