OSDN Git Service

(split) LDP: Update draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / wcpncpy.3
index 6717df6..91b552b 100644 (file)
 .\" 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
 .\"
-.\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
-.\" Translated Wed Oct 27 02:17:42 JST 1999
-.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
+.\"*******************************************************************
 .\"
-.TH WCPNCPY 3 2011-10-01 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O wcpncpy \- copy a fixed-size string of wide characters,
-.\"O returning a pointer to its end
-wcpncpy \- ¸ÇÄêĹ¤Î¥ï¥¤¥Éʸ»úʸ»úÎó¤ò¥³¥Ô¡¼¤·¡¢¤½¤ÎËöÈø¤ò»Ø¤¹¥Ý¥¤¥ó¥¿¤òÊÖ¤¹
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH WCPNCPY 3 2011\-10\-01 GNU "Linux Programmer's Manual"
+.SH 名前
+wcpncpy \- 固定長のワイド文字文字列をコピーし、その末尾を指すポインタを返す
+.SH 書式
 .nf
-.B #include <wchar.h>
+\fB#include <wchar.h>\fP
 .sp
-.BI "wchar_t *wcpncpy(wchar_t *" dest ", const wchar_t *" src ", size_t " n );
+\fBwchar_t *wcpncpy(wchar_t *\fP\fIdest\fP\fB, const wchar_t *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP
 .fi
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR wcpncpy ():
+\fBwcpncpy\fP():
 .PD 0
 .ad l
 .RS 4
-.TP 4
-.\"O Since glibc 2.10:
-glibc 2.10 °Ê¹ß:
+.TP  4
+glibc 2.10 以降:
 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
-.\"O Before glibc 2.10:
-glibc 2.10 ¤è¤êÁ°:
+.TP 
+glibc 2.10 より前:
 _GNU_SOURCE
 .RE
 .ad
 .PD
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR wcpncpy ()
-.\"O function is the wide-character equivalent
-.\"O of the
-.\"O .BR stpncpy (3)
-.\"O function.
-.BR wcpncpy ()
-´Ø¿ô¤Ï¡¢
-.BR stpncpy (3)
-´Ø¿ô¤ËÂбþ¤¹¤ë¥ï¥¤¥Éʸ»ú´Ø¿ô¤Ç¤¢¤ë¡£
-.\"O It copies at most \fIn\fP wide characters from the wide-character
-.\"O string pointed to by \fIsrc\fP,
-.\"O including the terminating null wide (L\(aq\\0\(aq),
-.\"O to the array pointed to by \fIdest\fP.
-¤³¤Î´Ø¿ô¤Ï¡¢\fIsrc\fP ¤¬»Ø¤¹¥ï¥¤¥Éʸ»úʸ»úÎ󤫤é \fIdest\fP ¤¬»Ø¤¹
-¥ï¥¤¥Éʸ»úʸ»úÎó¤Ë¡¢½ªÃ¼¤Î NULL ¥ï¥¤¥Éʸ»ú (L\(aq\\0\(aq) ¤ò´Þ¤á¤Æ
-ºÇÂç \fIn\fP Ê¸»ú¤ò¥³¥Ô¡¼¤¹¤ë¡£
-.\"O Exactly \fIn\fP wide characters are
-.\"O written at \fIdest\fP.
-.\"O If the length \fIwcslen(src)\fP is smaller than \fIn\fP,
-.\"O the remaining wide characters in the array pointed to
-.\"O by \fIdest\fP are filled with L\(aq\\0\(aq characters.
-.\"O If the length \fIwcslen(src)\fP is greater or equal
-.\"O to \fIn\fP, the string pointed to by \fIdest\fP will
-.\"O not be L\(aq\\0\(aq terminated.
-¤Á¤ç¤¦¤É \fIn\fP ¸Ä¤Î¥ï¥¤¥Éʸ»ú¤¬ \fIdest\fP ¤Ë¥³¥Ô¡¼¤µ¤ì¤ë¡£
-¤Ä¤Þ¤ê¡¢\fIwcslen(src)\fP ¤ÎŤµ¤¬ \fIn\fP ¤è¤ê¾®¤µ¤±¤ì¤Ð¡¢
-\fIdest\fP ¤¬»Ø¤¹ÇÛÎóÃæ¤Î»Ä¤ê¤Î¥ï¥¤¥Éʸ»ú¤Ï L\(aq\\0\(aq Ê¸»ú¤ÇËä¤á¤é¤ì¤ë¡£
-\fIwcslen(src)\fP ¤ÎŤµ¤¬ \fIn\fP °Ê¾å¤Ê¤é¤Ð¡¢\fIdest\fP ¤¬»Ø¤¹
-ʸ»úÎó¤Ï L\(aq\\0\(aq ¤Ç½ªÃ¼¤µ¤ì¤Ê¤¤¡£
+.SH 説明
+\fBwcpncpy\fP()  関数は、 \fBstpncpy\fP(3)  関数に対応するワイド文字関数である。 この関数は、\fIsrc\fP
+が指すワイド文字文字列から \fIdest\fP が指す ワイド文字文字列に、終端の NULL ワイド文字 (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
-.\"O The strings may not overlap.
-2 ¤Ä¤Îʸ»úÎó¤Ï½Å¤Ê¤Ã¤Æ¤¤¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
+これらの文字列は重なっていてはならない。
 .PP
-.\"O The programmer must ensure that there is room for at least \fIn\fP wide
-.\"O characters at \fIdest\fP.
-¥×¥í¥°¥é¥Þ¤Ï¡¢¾¯¤Ê¤¯¤È¤â \fIn\fP ¸Ä¤Î¥ï¥¤¥Éʸ»ú¤ò³ÊǼ¤Ç¤­¤ëÎΰè¤ò
-\fIdest\fP ¤Ë³ÎÊݤ·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O .BR wcpncpy ()
-.\"O returns a pointer to the last wide character written, that is,
-.\"O \fIdest + n \- 1\fP.
-.BR wcpncpy ()
-¤Ï¡¢ºÇ¸å¤Ë½ñ¤­¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Ø¤Î¥Ý¥¤¥ó¥¿¡¢
-¤¹¤Ê¤ï¤Á \fIdest + n \- 1\fP ¤òÊÖ¤¹¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2008.
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR stpncpy (3),
-.BR wcsncpy (3)
+プログラマは、少なくとも \fIn\fP 個のワイド文字が入る領域を \fIdest\fP に確保しなければならない。
+.SH 返り値
+\fBwcpncpy\fP()  は、最後に書き込まれたワイド文字へのポインタ、 すなわち \fIdest\fP+\fIn\fP\-1 を返す。
+.SH 準拠
+POSIX.1\-2008.
+.SH 関連項目
+\fBstpncpy\fP(3), \fBwcsncpy\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。