wcsncmp
From cppreference.com
| ヘッダー <wchar.h> で定義 |
||
| int wcsncmp( const wchar_t* lhs, const wchar_t* rhs, size_t count ); |
(C95 以降) | |
2つのヌル終端ワイド文字列を最大count文字まで比較します。比較は辞書順に行われます。
結果の符号は、比較される文字列で最初に異なるワイド文字のペアの値の差の符号になります。
lhsまたはrhsがヌル終端文字列へのポインタでない場合、動作は未定義です。
目次 |
[編集] パラメータ
| lhs, rhs | - | 比較するヌル終端ワイド文字列へのポインタ |
| count | - | 比較する最大文字数 |
[編集] 戻り値
lhsが辞書順でrhsより前にある場合は負の値。
lhsとrhsが等しい場合はゼロ。
lhsが辞書順でrhsより後にある場合は正の値。
[編集] 注意
wcscollやwcsxfrmとは異なり、この関数はロケールに依存しません。
[編集] 例
このコードを実行
#include <stdio.h> #include <wchar.h> #include <locale.h> void demo(const wchar_t *lhs, const wchar_t *rhs, int sz) { int rc = wcsncmp(lhs, rhs, sz); if(rc == 0) printf("First %d characters of [%ls] equal [%ls]\n", sz, lhs, rhs); else if(rc < 0) printf("First %d characters of [%ls] precede [%ls]\n", sz, lhs, rhs); else if(rc > 0) printf("First %d characters of [%ls] follow [%ls]\n", sz, lhs, rhs); } int main(void) { const wchar_t *str1 = L"안녕하세요"; const wchar_t *str2 = L"안녕히 가십시오"; setlocale(LC_ALL, "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 [안녕히 가십시오]
[編集] 参考文献
- C11標準 (ISO/IEC 9899:2011)
- 7.29.4.4.3 The wcsncmp function (p: 434)
- C99標準 (ISO/IEC 9899:1999)
- 7.24.4.4.3 The wcsncmp function (p: 380)
[編集] 関連項目
| (C95) |
2つのワイド文字列を比較する (関数) |
| (C95) |
2つの配列から指定された数のワイド文字を比較する (関数) |
| (C95) |
現在のロケールに従って2つのワイド文字列を比較する (関数) |
| C++ ドキュメント wcsncmp
| |
