wcsncmp | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

概要

ワイド文字列を指定文字数だけ比較する。

ヘッダ

wchar.h

形式

int wcsncmp(const wchar_t* s1, const wchar_t* s2, size_t n);

引数

s1

比較対象の文字列。

s2

比較対象の文字列。

n

比較する文字数。

戻り値

辞書順で s1 の方が小さければ（前に来れば） 0 より小さい値が、s1 の方が大きければ（後に来れば） 0 より大きい値が、s1 と s2 が同じであれば 0 が返される。

詳細

s1 と s2 を、先頭から n文字だけ比較する。ただし、ヌル文字が現れた時点で終了する。

注意

使用例

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    wprintf(L"%d\n", wcsncmp(L"abcde",L"abc", 3));
    wprintf(L"%d\n", wcsncmp(L"abcde",L"ab", 3));
    wprintf(L"%d\n", wcsncmp(L"abcde",L"abc123", 3));
}

実行結果：

0
1
0

関連

文字数を指定しない wcscmp関数がある。
ヌル文字を無視した比較を行うために、wmemcmp関数が使える。
マルチバイト文字列を比較するためには、strncmp関数が使える。

解説章