function is the wide-character equivalent
It allocates and returns a new wide-character string whose initial
contents is a duplicate of the wide-character string pointed to by
Memory for the new wide-character string is
and should be freed with
returns a pointer to the new wide-character string.
On error, it returns -1, with
set to indicate the cause of the error.
Insufficient memory available to allocate duplicate string.
For an explanation of the terms used in this section, see
This function is not specified in POSIX.1-2001,
and is not widely available on other systems.
This page is part of release 4.04 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at