draft/man3/wcpncpy.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  12 .\"
  13 .\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
  14 .\" Translated Wed Oct 27 02:17:42 JST 1999
  15 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  16 .\"
  17 .TH WCPNCPY 3 2011-10-01 "GNU" "Linux Programmer's Manual"
  18 .\"O .SH NAME
  19 .SH 名前
  20 .\"O wcpncpy \- copy a fixed-size string of wide characters,
  21 .\"O returning a pointer to its end
  22 wcpncpy \- 固定長のワイド文字文字列をコピーし、その末尾を指すポインタを返す
  23 .\"O .SH SYNOPSIS
  24 .SH 書式
  25 .nf
  26 .B #include <wchar.h>
  27 .sp
  28 .BI "wchar_t *wcpncpy(wchar_t *" dest ", const wchar_t *" src ", size_t " n );
  29 .fi
  30 .sp
  31 .in -4n
  32 .\"O Feature Test Macro Requirements for glibc (see
  33 .\"O .BR feature_test_macros (7)):
  34 glibc 向けの機能検査マクロの要件
  35 .RB ( feature_test_macros (7)
  36 参照):
  37 .in
  38 .sp
  39 .BR wcpncpy ():
  40 .PD 0
  41 .ad l
  42 .RS 4
  43 .TP 4
  44 .\"O Since glibc 2.10:
  45 glibc 2.10 以降:
  46 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
  47 .TP
  48 .\"O Before glibc 2.10:
  49 glibc 2.10 より前:
  50 _GNU_SOURCE
  51 .RE
  52 .ad
  53 .PD
  54 .\"O .SH DESCRIPTION
  55 .SH 説明
  56 .\"O The
  57 .\"O .BR wcpncpy ()
  58 .\"O function is the wide-character equivalent
  59 .\"O of the
  60 .\"O .BR stpncpy (3)
  61 .\"O function.
  62 .BR wcpncpy ()
  63 関数は、
  64 .BR stpncpy (3)
  65 関数に対応するワイド文字関数である。
  66 .\"O It copies at most \fIn\fP wide characters from the wide-character
  67 .\"O string pointed to by \fIsrc\fP,
  68 .\"O including the terminating null wide (L\(aq\\0\(aq),
  69 .\"O to the array pointed to by \fIdest\fP.
  70 この関数は、\fIsrc\fP が指すワイド文字文字列から \fIdest\fP が指す
  71 ワイド文字文字列に、終端の NULL ワイド文字 (L\(aq\\0\(aq) を含めて
  72 最大 \fIn\fP 文字をコピーする。
  73 .\"O Exactly \fIn\fP wide characters are
  74 .\"O written at \fIdest\fP.
  75 .\"O If the length \fIwcslen(src)\fP is smaller than \fIn\fP,
  76 .\"O the remaining wide characters in the array pointed to
  77 .\"O by \fIdest\fP are filled with L\(aq\\0\(aq characters.
  78 .\"O If the length \fIwcslen(src)\fP is greater or equal
  79 .\"O to \fIn\fP, the string pointed to by \fIdest\fP will
  80 .\"O not be L\(aq\\0\(aq terminated.
  81 ちょうど \fIn\fP 個のワイド文字が \fIdest\fP にコピーされる。
  82 つまり、\fIwcslen(src)\fP の長さが \fIn\fP より小さければ、
  83 \fIdest\fP が指す配列中の残りのワイド文字は L\(aq\\0\(aq 文字で埋められる。
  84 \fIwcslen(src)\fP の長さが \fIn\fP 以上ならば、\fIdest\fP が指す
  85 文字列は L\(aq\\0\(aq で終端されない。
  86 .PP
  87 .\"O The strings may not overlap.
  88 2 つの文字列は重なっていてはならない。
  89 .PP
  90 .\"O The programmer must ensure that there is room for at least \fIn\fP wide
  91 .\"O characters at \fIdest\fP.
  92 プログラマは、少なくとも \fIn\fP 個のワイド文字を格納できる領域を
  93 \fIdest\fP に確保しなければならない。
  94 .\"O .SH "RETURN VALUE"
  95 .SH 返り値
  96 .\"O .BR wcpncpy ()
  97 .\"O returns a pointer to the last wide character written, that is,
  98 .\"O \fIdest + n \- 1\fP.
  99 .BR wcpncpy ()
 100 は、最後に書き込まれたワイド文字へのポインタ、
 101 すなわち \fIdest + n \- 1\fP を返す。
 102 .\"O .SH "CONFORMING TO"
 103 .SH 準拠
 104 POSIX.1-2008.
 105 .\"O .SH "SEE ALSO"
 106 .SH 関連項目
 107 .BR stpncpy (3),
 108 .BR wcsncpy (3)