wcscmp
提供: cppreference.com
| ヘッダ <wchar.h> で定義
|
||
| int wcscmp( const wchar_t *lhs, const wchar_t *rhs ); |
(C95以上) | |
2つのヌル終端ワイド文字列を辞書的に比較します。
結果の符号は比較する文字列内の最初の異なるワイド文字の組の値の差の符号です。
lhs または rhs がヌル終端ワイド文字列を指すポインタでない場合、動作は未定義です。
目次 |
[編集] 引数
| lhs, rhs | - | 比較するヌル終端ワイド文字列を指すポインタ |
[編集] 戻り値
辞書順で lhs が rhs より前に現れる場合は負の値。
lhs と rhs が等しい場合はゼロ。
辞書順で lhs が rhs より後に現れる場合は正の値。
[編集] ノート
この関数は、 wcscoll と異なり、ロケール対応ではなく、異なる Unicode ブロックの文字が使用される時やコードユニットの順序が照合順序と一致しないときは、順序は意味がないかもしれません。
[編集] 例
Run this code
#include <wchar.h> #include <stdio.h> #include <locale.h> void demo(const wchar_t* lhs, const wchar_t* rhs) { int rc = wcscmp(lhs, rhs); const char *rel = rc < 0 ? "precedes" : rc > 0 ? "follows" : "equals"; setlocale(LC_ALL, "en_US.utf8"); printf("[%ls] %s [%ls]\n", lhs, rel, rhs); } int main(void) { const wchar_t* string = L"どうもありがとうございます"; demo(string, L"どうも"); demo(string, L"助かった"); demo(string + 9, L"ありがとうございます" + 6); }
出力例:
[どうもありがとうございます] follows [どうも] [どうもありがとうございます] precedes [助かった] [ざいます] equals [ざいます]
