std::wcsxfrm

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

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

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端ワイド文字列

関数
文字操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11) wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
数値形式への変換
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
配列操作
wmemcpy
wmemmove
wmemcmp
wmemchr
wmemset

 

ヘッダ <cwchar> で定義
std::size_t wcsxfrm(wchar_t* dest, constwchar_t* src, std::size_t count );

現在の C のロケールにおいて、 std::wcscoll で2つの文字列を比較したのと同じ結果を std::wcscmp で変換後の2つの文字列を比較することで得られるように、 src の指すヌル終端ワイド文字列を処理系定義の形式に変換します。

変換後の文字列の最初の count 個の文字 (終端のヌル文字を含む) が dest に書き込まれ、完全な変換後の文字列の長さ (終端のヌル文字を除く) が返されます。

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

ノート

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

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

引数

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

戻り値

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

例

Run this code

#include <iostream>#include <cwchar>   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';elsestd::wcout<< in2 <<" before "<< in1 <<'\n';   std::wcout<<"In lexicographical comparison: ";if(in1 < in2)std::wcout<< in1 <<" before "<< in2 <<'\n';elsestd::wcout<< in2 <<" before "<< in1 <<'\n';   }

出力:

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

関連項目

strxfrm	strcoll と同じ結果を strcmp で得られるように文字列を変換します (関数)
do_transform [仮想]	照合を比較に置き換えられるように文字列を変換します (std::collate<CharT>の仮想プロテクテッドメンバ関数)
wcscoll	現在のロケールに従って2つのワイド文字列を比較します (関数)
wcsxfrm の C言語リファレンス