Manpages

名 前

wcsncasecmp − 大 文 字 と 小 文 字 を 区 別 せ ず 、 2 つ の 固 定 長 の ワ イ ド 文 字 文 字 列 を 比 較 す る

書 式

#include <wchar.h>

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

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):

wcsncasecmp():

glibc 2.10 以 降 :

_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L

glibc 2.10 よ り 前 :

_GNU_SOURCE

説 明

wcsncasecmp() 関 数 は 、 strncasecmp(3) 関 数 に 対 応 す る ワ イ ド 文 字 関 数 で あ る 。 こ の 関 数 は 、 s1 が 指 す ワ イ ド 文 字 文 字 列 と s2 が 指 す ワ イ ド 文 字 文 字 列 を 比 較 す る が 、 最 大 で も 先 頭 の ワ イ ド 文 字 n 個 し か 比 較 し な い 。 ま た 、 大 文 字 と 小 文 字 (towupper(3), towlower(3)) は 区 別 し な い 。

返 り 値

wcsncasecmp() 関 数 は 、 s1 と s2 が そ れ ぞ れ 指 す 文 字 列 を n 文 字 に 収 ま る よ う に 切 り 詰 め た も の を 、 大 文 字 と 小 文 字 の 違 い を 無 視 し て 比 較 し た と き に 等 し け れ ば 0 を 返 す 。 こ の 関 数 は 、 大 文 字 と 小 文 字 を 区 別 し な い 場 合 に 、 s1 を 切 り 詰 め た も の が s2 を 切 り 詰 め た も の よ り 大 き け れ ば 正 の 値 を 返 す 。 こ の 関 数 は 、 大 文 字 と 小 文 字 を 区 別 し な い 場 合 に 、 s1 を 切 り 詰 め た も の が s2 を 切 り 詰 め た も の よ り 小 さ け れ ば 負 の 値 を 返 す 。

バ ー ジ ョ ン

wcsncasecmp() 関 数 は glibc バ ー ジ ョ ン 2.1 以 降 で 提 供 さ れ て い る 。

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )

wcsncasecmp() 関 数 は 、 例 外 付 き の ス レ ッ ド セ ー フ で あ る 。 実 行 中 に setlocale(3) を 呼 び 出 し て ロ ケ ー ル を 変 更 し な い 限 り 、 マ ル チ ス レ ッ ド ア プ リ ケ ー シ ョ ン で 安 全 に 使 用 す る こ と が で き る 。

準 拠

POSIX.1−2008. こ の 関 数 は POSIX.1−2001 で は 規 定 さ れ て い な い が 、 Linux 以 外 の 他 の シ ス テ ム で 広 く 利 用 可 能 で あ る 。

注 意

wcsncasecmp() の 動 作 は 、 現 在 の ロ ケ ー ル の LC_CTYPE カ テ ゴ リ ー に 依 存 す る 。

関 連 項 目

strncasecmp(3), wcsncmp(3)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。