1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
15 .TH WCSDUP 3 2013-04-19 "GNU" "Linux Programmer's Manual"
17 wcsdup \- duplicate a wide-character string
22 .BI "wchar_t *wcsdup(const wchar_t *" s );
26 Feature Test Macro Requirements for glibc (see
27 .BR feature_test_macros (7)):
36 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
46 function is the wide-character equivalent
50 It allocates and returns a new wide-character string whose initial
51 contents is a duplicate of the wide-character string pointed to by
54 Memory for the new wide-character string is
57 and should be freed with
62 returns a pointer to the new wide-character string.
63 On error, it returns \-1, with
65 set to indicate the cause of the error.
69 Insufficient memory available to allocate duplicate string.
72 This function is not specified in POSIX.1-2001,
73 and is not widely available on other systems.
74 .\" present in libc5 and glibc 2.0 and later
79 This page is part of release 3.68 of the Linux
82 A description of the project,
83 information about reporting bugs,
84 and the latest version of this page,
86 \%http://www.kernel.org/doc/man\-pages/.