std:: wcsxfrm

src が指すナル終端ワイド文字列を、現在のCロケールにおいて、変換後の2つの文字列を std::wcscmp で比較した結果が、元の文字列を std::wcscoll で比較した結果と同じになるような、実装定義の形式に変換します。

変換された文字列の最初の count 文字が、終端のnull文字を含めて宛先に書き込まれ、完全な変換された文字列の長さが、終端のnull文字を除いて返されます。

count が ​ 0 ​ の場合、 dest はヌルポインタでも許可されます。

注記

変換された文字列全体を受け取ることができる正しいバッファの長さは 1 + std :: wcsxfrm ( nullptr, src, 0 ) です。

この関数は、同じワイド文字列またはワイド文字列のセットを使用して複数のロケール依存の比較を行う場合に使用されます。なぜなら、すべての文字列を一度だけ変換するために std::wcsxfrm を使用し、その後変換されたワイド文字列を std::wcscmp で比較する方が効率的だからです。

パラメータ

戻り値

変換後のワイド文字列の長さ（終端のnull文字を含まない）。

例

#include <cwchar>
#include <iostream>
int main()
{
    std::setlocale(LC_ALL, "sv_SE.utf8");
    std::wstring in1 = L"\u00e5r";
    std::wstring out1(1 + std::wcsxfrm(nullptr, in1.c_str(), 0), L' ');
    std::wstring in2 = L"\u00e4ngel";
    std::wstring out2(1 + std::wcsxfrm(nullptr, in2.c_str(), 0), L' ');
    std::wcsxfrm(&out1[0], in1.c_str(), out1.size());
    std::wcsxfrm(&out2[0], in2.c_str(), out2.size());
    std::wcout << "In the Swedish locale: ";
    if (out1 < out2)
        std::wcout << in1 << " before " << in2 << '\n';
    else
        std::wcout << in2 << " before " << in1 << '\n';
    std::wcout << "In lexicographical comparison: ";
    if (in1 < in2)
        std::wcout << in1 << " before " << in2 << '\n';
    else
        std::wcout << in2 << " before " << in1 << '\n';
}

In the Swedish locale: år before ängel
In lexicographical comparison: ängel before år

関連項目