std::wcsncmp
From cppreference.com
| ヘッダ <cwchar> で定義 |
||
| int wcsncmp( const wchar_t* lhs, const wchar_t* rhs, std::size_t count ); |
||
count 個までのワイド文字を、ヌル終端された2つのワイド文字列と比較します。比較は辞書順で行われます。
結果の符号は、比較される文字列で最初に異なるワイド文字のペアの値の差の符号になります。
lhs または rhs がヌル終端された文字列へのポインタでない場合、未定義の動作となります。
目次 |
[編集] パラメータ
| lhs, rhs | - | 比較するヌル終端ワイド文字列へのポインタ |
| count | - | 比較する最大文字数 |
[編集] 戻り値
lhsが辞書順でrhsより前にある場合、負の値。
lhsとrhsが等しく比較された場合はゼロ
lhsが辞書順でrhsより後にある場合、正の値。
[編集] 例
このコードを実行
#include <clocale> #include <cwchar> #include <iostream> #include <locale> void demo(const wchar_t* lhs, const wchar_t* rhs, int sz) { int rc = std::wcsncmp(lhs, rhs, sz); if (rc == 0) std::wcout << "First " << sz << " characters of [" << lhs << "] equal [" << rhs << "]\n"; else if (rc < 0) std::wcout << "First " << sz << " characters of [" << lhs << "] precede [" << rhs << "]\n"; else if (rc > 0) std::wcout << "First " << sz << " characters of [" << lhs << "] follow [" << rhs << "]\n"; } int main() { const wchar_t str1[] = L"안녕하세요"; const wchar_t str2[] = L"안녕히 가십시오"; std::setlocale(LC_ALL, "en_US.utf8"); std::wcout.imbue(std::locale("en_US.utf8")); demo(str1, str2, 5); demo(str2, str1, 8); demo(str1, str2, 2); }
出力
First 5 characters of [안녕하세요] precede [안녕히 가십시오] First 8 characters of [안녕히 가십시오] follow [안녕하세요] First 2 characters of [안녕하세요] equal [안녕히 가십시오]
[編集] 関連項目
| 2つの文字列から指定された文字数を比較する (関数) | |
| 2つのワイド文字列を比較する (関数) | |
| 2つの配列から指定された数のワイド文字を比較する (関数) | |
| 現在のロケールに従って2つのワイド文字列を比較する (関数) | |
| C言語のドキュメント for wcsncmp
| |