wcscmp
提供: cppreference.com
<tbody>
</tbody>
| ヘッダ <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 [ざいます]
参考文献
- C11 standard (ISO/IEC 9899:2011):
- 7.29.4.4.1 The wcscmp function (p: 433)
- C99 standard (ISO/IEC 9899:1999):
- 7.24.4.4.1 The wcscmp function (p: 379)
関連項目
(C95) |
2つのワイド文字列の文字を一定量比較します (関数) |
(C95) |
2つの配列のワイド文字を一定量比較します (関数) |
| 2つの文字列を比較します (関数) | |
(C95) |
現在のロケールに従ってワイド文字列を比較します (関数) |
wcscmp の C++リファレンス
| |