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