OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man3 / wcpncpy.3
index ff11b28..389cabf 100644 (file)
 .\"   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 2010-09-15 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
-wcpncpy \- ¸ÇÄêĹ¤Î¥ï¥¤¥Éʸ»úʸ»úÎó¤ò¥³¥Ô¡¼¤·¡¢¤½¤ÎËöÈø¤ò»Ø¤¹¥Ý¥¤¥ó¥¿¤òÊÖ¤¹
-.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
-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
-glibc 2.10 °Ê¹ß:
+.TP  4
+glibc 2.10 以降:
 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
-glibc 2.10 ¤è¤êÁ°:
+.TP 
+glibc 2.10 より前:
 _GNU_SOURCE
 .RE
 .ad
 .PD
-.SH ÀâÌÀ
-.BR wcpncpy ()
-´Ø¿ô¤Ï¡¢
-.BR stpncpy (3)
-´Ø¿ô¤ËÂбþ¤¹¤ë¥ï¥¤¥Éʸ»ú´Ø¿ô¤Ç¤¢¤ë¡£
-¤³¤Î´Ø¿ô¤Ï¡¢\fIsrc\fP ¤¬»Ø¤¹¥ï¥¤¥Éʸ»úʸ»úÎ󤫤é \fIdest\fP ¤¬»Ø¤¹¥ï¥¤¥Éʸ»úʸ»úÎó
-¤Ë¡¢½ªÃ¼¤Î L\(aq\\0\(aq ¤ò´Þ¤á¤ÆºÇÂç \fIn\fP Ê¸»ú¤ò ¥³¥Ô¡¼¤¹¤ë¡£¤Á¤ç¤¦¤É
-\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
-2 ¤Ä¤Îʸ»úÎó¤Ï½Å¤Ê¤Ã¤Æ¤¤¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
+これらの文字列は重なっていてはならない。
 .PP
-¥×¥í¥°¥é¥Þ¤Ï¡¢¾¯¤Ê¤¯¤È¤â \fIn\fP ¸Ä¤Î¥ï¥¤¥Éʸ»ú¤ò³ÊǼ¤Ç¤­¤ëÎΰè¤ò
-\fIdest\fP ¤Ë³ÎÊݤ·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-.BR wcpncpy ()
-¤Ï¡¢ºÇ¸å¤Ë½ñ¤­¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Ø¤Î¥Ý¥¤¥ó¥¿¡¢
-¤¹¤Ê¤ï¤Á \fIdest + n \- 1\fP ¤òÊÖ¤¹¡£
-.SH ½àµò
-¤³¤Î´Ø¿ô¤Ï GNU ³ÈÄ¥¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR stpncpy (3),
-.BR wcsncpy (3)
+プログラマは、少なくとも \fIn\fP 個のワイド文字が入る領域を \fIdest\fP に確保しなければならない。
+.SH 返り値
+\fBwcpncpy\fP()  は、最後に書き込まれたワイド文字へのポインタ、 すなわち \fIdest + n \- 1\fP を返す。
+.SH 準拠
+POSIX.1\-2008.
+.SH 関連項目
+\fBstpncpy\fP(3), \fBwcsncpy\fP(3)