std::wcsxfrm

 

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> で定義
std::size_t wcsxfrm( wchar_t* dest, const wchar_t* src, std::size_t count );

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

変換された文字列の最初の count 文字が宛先に書き込まれ、終端のヌル文字も含まれます。完全な変換された文字列の長さ（終端のヌル文字を除く）が返されます。

count が ​0​ の場合、dest はヌルポインタでもかまいません。

Notes

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

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

Parameters

dest	-	変換された文字列を書き込む、ワイドヌル終端文字列の最初の要素へのポインタ
src	-	変換するヌル終端ワイド文字列へのポインタ
count	-	出力する最大文字数

Return value

変換されたワイド文字列の長さ（終端のヌル文字を除く）。

Example

このコードを実行

#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

See also

strxfrm	strcmp が strcoll と同じ結果を生成するように文字列を変換する (関数)
do_transform [virtual]	照合を比較に置き換えることができるように文字列を変換します。 (std::collate<CharT> の仮想保護メンバ関数)
wcscoll	現在のロケールに従って2つのワイド文字列を比較する (関数)
C documentation for wcsxfrm