release/man3/wcpcpy.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 Mon Oct 25 22:24:35 JST 1999
  15 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  16 .\"
  17 .TH WCPCPY 3  2011-10-01 "GNU" "Linux Programmer's Manual"
  18 .SH 名前
  19 wcpcpy \- ワイド文字文字列をコピーし、その末尾を指すポインタを返す
  20 .SH 書式
  21 .nf
  22 .B #include <wchar.h>
  23 .sp
  24 .BI "wchar_t *wcpcpy(wchar_t *" dest ", const wchar_t *" src );
  25 .fi
  26 .sp
  27 .in -4n
  28 glibc 向けの機能検査マクロの要件
  29 .RB ( feature_test_macros (7)
  30 参照):
  31 .in
  32 .sp
  33 .BR wcpcpy ():
  34 .PD 0
  35 .ad l
  36 .RS 4
  37 .TP 4
  38 glibc 2.10 以降:
  39 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
  40 .TP
  41 glibc 2.10 より前:
  42 _GNU_SOURCE
  43 .RE
  44 .ad
  45 .PD
  46 .SH 説明
  47 .BR wcpcpy ()
  48 関数は、
  49 .BR stpcpy (3)
  50 関数に対応するワイド文字関数である。
  51 この関数は \fIsrc\fP が指すワイド文字文字列を、
  52 終端の NULL ワイド文字 (L\(aq\\0\(aq) を含めて、
  53 \fIdest\fP が指す配列にコピーする。
  54 .PP
  55 これらの文字列は重なっていてはならない。
  56 .PP
  57 プログラマは、\fIdest\fP が指す領域に少なくともワイド文字
  58 \fIwcslen(src)+1\fP 個分の領域を確保しなければならない。
  59 .SH 返り値
  60 .BR wcpcpy ()
  61 は、ワイド文字文字列 \fIdest\fP の末尾、つまり終端の NULL ワイド文字
  62 を指すポインタを返す。
  63 .SH 準拠
  64 POSIX.1-2008.
  65 .SH 関連項目
  66 .BR strcpy (3),
  67 .BR wcscpy (3)