std::wcscoll

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端ワイド文字列

関数
文字の分類
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
文字操作
towlower towupper	towctrans wctrans
数値フォーマットへの変換
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
文字列検査
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
配列操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
型 wctrans_t wctype_t wint_t	マクロ WCHAR_MIN WCHAR_MAX WEOF

 

ヘッダ <cwchar> で定義
int wcscoll( const wchar_t* lhs, const wchar_t* rhs );

ロケールで最後にインストールされた std::setlocale による、LC_COLLATE カテゴリで定義されるロケールに従って、2つのヌル終端ワイド文字列を比較します。

パラメータ

lhs, rhs

-

比較するヌル終端ワイド文字列へのポインタ

返り値

lhs が rhs より *小さい* (先行する) 場合、負の値。

​0​ If lhs is *equal to* rhs.

lhs が rhs より *大きい* (後続する) 場合、正の値。

注記

照合順序は辞書順です。つまり、文字の国立アルファベットでの位置 (その *同値クラス*) が、大文字/小文字やバリアントよりも優先されます。同値クラス内では、小文字が対応する大文字よりも前に照合され、ダイアクリティカルマーク付きの文字にはロケール固有の順序が適用される場合があります。一部のロケールでは、文字のグループが単一の *照合単位* として比較されます。たとえば、チェコ語の "ch" は "h" の後に、"i" の前に来ます。ハンガリー語の "dzs" は "dz" の後に、"g" の前に来ます。

例

このコードを実行

#include <clocale>
#include <iostream>
 
void try_compare(const wchar_t* p1, const wchar_t* p2)
{
    if (std::wcscoll(p1, p2) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "cs_CZ.utf8");
    std::wcout << "In the Czech locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"år", L"ängel");
 
    std::setlocale(LC_COLLATE, "sv_SE.utf8");
    std::wcout << "In the Swedish locale: ";
    try_compare(L"år", L"ängel");
}

出力

In the American locale: chrt before hrnec
In the Czech locale: hrnec before chrt
In the American locale: ängel before år
In the Swedish locale: år before ängel

関連項目

strcoll	現在のロケールに従って2つの文字列を比較する (関数)
do_compare [virtual]	このファセットの照合規則を使用して2つの文字列を比較します。 (std::collate<CharT> の仮想保護メンバー関数)
wcsxfrm	wcscmpがwcscollと同じ結果を生成するようにワイド文字列を変換する (関数)
C ドキュメント for wcscoll