Manpages

名 前

wcsnlen − 固 定 長 の ワ イ ド 文 字 文 字 列 の 長 さ を 求 め る

書 式

#include <wchar.h>

size_t wcsnlen(const wchar_t *s, size_t maxlen);

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

wcsncasecmp():

glibc 2.10 以 降 :

_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L

glibc 2.10 よ り 前 :

_GNU_SOURCE

説 明

wcsnlen() 関 数 は 、 strnlen(3) 関 数 に 対 応 す る ワ イ ド 文 字 関 数 で あ る 。 こ の 関 数 は 、 s が 指 す 文 字 列 中 の ワ イ ド 文 字 の 数 を 返 す が 、 返 さ れ る の は ワ イ ド 文 字 で 最 大 maxlen 文 字 ま で で あ る (こ の パ ラ メ ー タ ー は バ イ ト 数 で は な い 点 に 注 意 )。 ま た 、 終 端 の ヌ ル ワ イ ド 文 字 (L'\0') は 含 ま な い 。 こ れ を 行 う 際 に は 、 wcsnlen() は s が 指 す ワ イ ド 文 字 列 の 最 初 の maxlen 文 字 し か 見 ず 、 決 し て s+maxlen 文 字 を 超 え て 文 字 列 を 参 照 す る こ と は な い 。

返 り 値

wcsnlen() 関 数 は 、 wcslen(s) の 値 が maxlen よ り 小 さ け れ ば wcslen(s) を 返 す 。 あ る い は 、 s が 指 す ワ イ ド 文 字 列 中 の 最 初 の maxlen 文 字 に ヌ ル ワ イ ド 文 字 が 含 ま れ て い な け れ ば maxlen を 返 す 。

バ ー ジ ョ ン

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

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 wcsnlen() は ス レ ッ ド セ ー フ で あ る 。

準 拠

POSIX.1−2008.

関 連 項 目

strnlen(3), wcslen(3)

こ の 文 書 に つ い て

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