CStringT::Collate
更新 : 2007 年 11 月
汎用テキスト関数 _tcscoll を使用して、2 つの文字列を比較します。
int Collate(
PCXSTR psz
) const throw();
パラメータ
- psz
比較対象の文字列。
戻り値
2 つの文字列が一致した場合は 0 を返します。CStringT オブジェクトが psz 未満の場合は 0 未満の値を返します。CStringT オブジェクトが psz を超える場合は 0 を超える値を返します。
解説
汎用テキスト関数 _tcscoll は TCHAR.H で定義されています。この関数は、コンパイル時に定義された文字セットに応じて、strcoll、wcscoll、または _mbscoll に割り当てられます。各関数は、現在使用中のコード ページに基づき、大文字小文字を区別して文字列を比較します。詳細については、「strcoll、wcscoll、_mbscoll、_strcoll_l、_wcscoll_l、_mbscoll_l」を参照してください。
使用例
// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
_tsetlocale(LC_ALL, _T("german"));
CAtlString str1 = _T("strasse");
CAtlString str2 = _T("strae");
int n;
n = str1.Collate(str2);
ASSERT(n == 0);
// Comparison is a strict ASCII comparison with no language rules.
n = str1.Compare(str2);
ASSERT(n < 0);
必要条件
ヘッダー : cstringt.h