名 前
wcpncpy − 固 定 長 の ワ イ ド 文 字 文 字 列 を コ ピ ー し 、 そ の 末 尾 を 指 す ポ イ ン タ ー を 返 す
書 式
#include <wchar.h>
wchar_t *wcpncpy(wchar_t *dest, const wchar_t *src, size_t n);
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
wcpncpy():
glibc 2.10 以 降 :
_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
glibc 2.10 よ り 前 :
_GNU_SOURCE
説 明
wcpncpy() 関 数 は 、 stpncpy(3) 関 数 に 対 応 す る ワ イ ド 文 字 関 数 で あ る 。 こ の 関 数 は 、 src が 指 す ワ イ ド 文 字 文 字 列 か ら dest が 指 す ワ イ ド 文 字 文 字 列 に 、 終 端 の ヌ ル ワ イ ド 文 字 (L'\0') を 含 め て 最 大 n 文 字 を コ ピ ー す る 。 ち ょ う ど n 個 の ワ イ ド 文 字 が dest に コ ピ ー さ れ る 。 つ ま り 、 wcslen(src) の 長 さ が n よ り 小 さ け れ ば 、 dest が 指 す 配 列 中 の 残 り の ワ イ ド 文 字 は L'\0' 文 字 で 埋 め ら れ る 。 wcslen(src) の 長 さ が n 以 上 な ら ば 、 dest が 指 す 文 字 列 は L'\0' で 終 端 さ れ な い 。 こ れ ら の 文 字 列 は 重 な っ て い て は な ら な い 。 プ ロ グ ラ マ は 、 少 な く と も n 個 の ワ イ ド 文 字 が 入 る 領 域 を dest に 確 保 し な け れ ば な ら な い 。
返 り 値
wcpncpy() は 、 最 後 に 書 き 込 ま れ た ワ イ ド 文 字 へ の ポ イ ン タ ー 、 す な わ ち dest+n−1 を 返 す 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 wcpncpy() は ス レ ッ ド セ ー フ で あ る 。
準 拠
POSIX.1−2008.
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。