std::wcsxfrm
提供: cppreference.com
<tbody>
</tbody>
| ヘッダ <cwchar> で定義
|
||
std::size_t wcsxfrm( wchar_t* dest, const wchar_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';
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
関連項目
| strcoll と同じ結果を strcmp で得られるように文字列を変換します (関数) | |
[仮想] |
照合を比較に置き換えられるように文字列を変換します ( std::collate<CharT>の仮想プロテクテッドメンバ関数)
|
| 現在のロケールに従って2つのワイド文字列を比較します (関数) | |
wcsxfrm の C言語リファレンス
|