名 前
wcsncmp − 2 つ の 固 定 長 ワ イ ド 文 字 文 字 列 を 比 較 す る
書 式
#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] よ り 小 さ け れ ば 負 の 値 を 返 す 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 wcsncmp() は ス レ ッ ド セ ー フ で あ る 。
準 拠
C99.
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。