draft/man3/wcsdup.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 18 22:36:21 JST 1999
  15 .\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  16 .\" Updated & Modified Sun Jun  6 13:23:46 JST 2004
  17 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  18 .\"
  19 .TH WCSDUP 3  2010-09-15 "GNU" "Linux Programmer's Manual"
  20 .\"O .SH NAME
  21 .SH 名前
  22 .\"O wcsdup \- duplicate a wide-character string
  23 wcsdup \- ワイド文字文字列を複製する
  24 .\"O .SH SYNOPSIS
  25 .SH 書式
  26 .nf
  27 .B #include <wchar.h>
  28 .sp
  29 .BI "wchar_t *wcsdup(const wchar_t *" s );
  30 .fi
  31 .sp
  32 .in -4n
  33 .\"O Feature Test Macro Requirements for glibc (see
  34 .\"O .BR feature_test_macros (7)):
  35 glibc 向けの機能検査マクロの要件
  36 .RB ( feature_test_macros (7)
  37 参照):
  38 .in
  39 .sp
  40 .BR wcsdup ():
  41 .PD 0
  42 .ad l
  43 .RS 4
  44 .TP 4
  45 .\"O Since glibc 2.10:
  46 glibc 2.10 以降:
  47 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
  48 .TP
  49 .\"O Before glibc 2.10:
  50 glibc 2.10 より前:
  51 _GNU_SOURCE
  52 .RE
  53 .ad
  54 .PD
  55 .\"O .SH DESCRIPTION
  56 .SH 説明
  57 .\"O The
  58 .\"O .BR wcsdup ()
  59 .\"O function is the wide-character equivalent
  60 .\"O of the
  61 .\"O .BR strdup (3)
  62 .\"O function.
  63 .\"O It allocates and returns a new wide-character string whose initial
  64 .\"O contents is a duplicate of the wide-character string pointed to by \fIs\fP.
  65 .BR wcsdup ()
  66 関数は、
  67 .BR strdup (3)
  68 関数のワイド文字版である。
  69 この関数はポインタ \fIs\fP が指し示すワイド文字文字列の複製を
  70 新しい領域に割り当てて返す。
  71 .PP
  72 .\"O Memory for the new wide-character string is
  73 .\"O obtained with
  74 .\"O .BR malloc (3),
  75 .\"O and should be freed with
  76 .\"O .BR free (3).
  77 新しいワイド文字文字列のためのメモリは
  78 .BR malloc (3)
  79 を使って割り当てられる。
  80 この領域は
  81 .BR free (3)
  82 を使って解放すべきである。
  83 .\"O .SH "RETURN VALUE"
  84 .SH 返り値
  85 .\"O The
  86 .\"O .BR wcsdup ()
  87 .\"O function returns a pointer
  88 .\"O to the new wide-character string,
  89 .\"O or NULL if sufficient memory was not available.
  90 .BR wcsdup ()
  91 関数は、新しいワイド文字文字列へのポインタを返す。
  92 十分なメモリがなければ NULL を返す。
  93 .\"O .SH ERRORS
  94 .SH エラー
  95 .TP
  96 .B ENOMEM
  97 .\"O Insufficient memory available to allocate duplicate string.
  98 複製文字列を割り当てるのに十分なメモリがない。
  99 .\"O .SH "CONFORMING TO"
 100 .SH 準拠
 101 POSIX.1-2008.
 102 .\"O This function is not specified in POSIX.1-2001,
 103 .\"O and is not widely available on other systems.
 104 この関数は POSIX.1-2001 では規定されていないが、
 105 Linux 以外の他のシステムで広く利用可能である。
 106 .\"O .\" present in libc5 and glibc 2.0 and later
 107 .\" libc5 と glibc 2.0 とそれ以降に存在する。
 108 .\"O .SH "SEE ALSO"
 109 .SH 関連項目
 110 .BR strdup (3),
 111 .BR wcscpy (3)