.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\" %%%LICENSE_END
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Translated Wed Oct 27 02:17:42 JST 1999
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.TH WCPNCPY 3 2019\-03\-06 GNU "Linux Programmer's Manual"
.SH 名前
wcpncpy \- 固定長のワイド文字文字列をコピーし、その末尾を指すポインターを返す
.SH 書式
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *wcpncpy(wchar_t *\fP\fIdest\fP\fB, const wchar_t *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP
.fi
.PP
.RS -4
glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
.RE
.PP
\fBwcpncpy\fP():
.PD 0
.ad l
.RS 4
.TP  4
glibc 2.10 以降:
_POSIX_C_SOURCE\ >=\ 200809L
.TP 
glibc 2.10 より前:
_GNU_SOURCE
.RE
.ad
.PD
.SH 説明
\fBwcpncpy\fP()  関数は、 \fBstpncpy\fP(3)  関数に対応するワイド文字関数である。 この関数は、\fIsrc\fP
が指すワイド文字文字列から \fIdest\fP が指す ワイド文字文字列に、終端のヌルワイド文字 (L\(aq\e0\(aq) を含めて 最大 \fIn\fP
文字をコピーする。 ちょうど \fIn\fP 個のワイド文字が \fIdest\fP にコピーされる。 つまり、\fIwcslen(src)\fP の長さが \fIn\fP
より小さければ、 \fIdest\fP が指す配列中の残りのワイド文字は L\(aq\e0\(aq 文字で埋められる。 \fIwcslen(src)\fP の長さが
\fIn\fP 以上ならば、\fIdest\fP が指す 文字列は L\(aq\e0\(aq で終端されない。
.PP
これらの文字列は重なっていてはならない。
.PP
プログラマは、少なくとも \fIn\fP 個のワイド文字が入る領域を \fIdest\fP に確保しなければならない。
.SH 返り値
\fBwcpncpy\fP()  は、最後に書き込まれたワイド文字へのポインター、 すなわち \fIdest\fP+\fIn\fP\-1 を返す。
.SH 属性
この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。
.TS
allbox;
lb lb lb
l l l.
インターフェース	属性	値
T{
\fBwcpncpy\fP()
T}	Thread safety	MT\-Safe
.TE
.SH 準拠
POSIX.1\-2008.
.SH 関連項目
\fBstpncpy\fP(3), \fBwcsncpy\fP(3)
.SH この文書について
この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は
\%https://www.kernel.org/doc/man\-pages/ に書かれている。