名前空間
変種
操作

wcsncmp

提供: cppreference.com
< c‎ | string‎ | wide
ヘッダ <wchar.h> で定義
int wcsncmp( const wchar_t* lhs, const wchar_t* rhs, size_t count );
(C95およびそれ以降)

2つのヌル終端ワイド文字列の最大 count 個のワイド文字を比較します。 比較は辞書順で行われます。

結果の符号は比較する文字列内の最初の異なるワイド文字の組の値の差の符号です。

lhs または rhs がヌル終端文字列を指すポインタでない場合、動作は未定義です。

目次

[編集] 引数

lhs, rhs - 比較するヌル終端ワイド文字列を指すポインタ
count - 比較する最大文字数

[編集] 戻り値

辞書順で lhsrhs より前に現れる場合は負の値。

lhsrhs が等しい場合はゼロ。

辞書順で lhsrhs より後に現れる場合は正の値。

[編集] ノート

この関数は、 wcscollwcsxfrm と異なり、ロケール対応ではありません。

[編集]

#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 standard (ISO/IEC 9899:2011):
  • 7.29.4.4.3 The wcsncmp function (p: 434)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.24.4.4.3 The wcsncmp function (p: 380)

[編集] 関連項目

(C95)
2つのワイド文字列を比較します
(関数) [edit]
2つの配列のワイド文字を一定量比較します
(関数) [edit]
現在のロケールに従ってワイド文字列を比較します
(関数) [edit]