wcsncmp

書式

#include <wchar.h>

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

説明

wcsncmp() 関数は、 strncmp(3) 関数に対応するワイド文字関数である。この関数は、 s1 が指すワイド文字文字列と s2 が指すワイド文字文字列を比較するが、最大でも先頭のワイド文字 n 個までしか比較しない。またいずれかの文字列にヌルワイド文字 (L'\0') が現れたら、比較はその位置で終了する。

wcsncmp() 関数は、s1 と s2 がそれぞれ指す文字列を n 文字に収まるように切り詰めたものが等しければ 0 を返す。この関数は、異なる文字が最初に現われた位置 i (i < n) において、その位置にある文字 s1[i] が s2[i] より大きければ正の値を返す。異なる文字が最初に現われた位置 i (i < n) において、その位置にある文字 s1[i] が s2[i] より小さければ負の値を返す。