This file and its contents are supplied under the terms of the
Common Development and Distribution License ("CDDL"), version 1.0.
You may only use this file in accordance with the terms of version
1.0 of the CDDL.

A full copy of the text of the CDDL should have accompanied this
source. A copy of the CDDL is also available via the Internet at
http://www.illumos.org/license/CDDL.


Copyright 2014 Garrett D'Amore <garrett@damore.org>

.Dd "Nov 4, 2014" .Dt WCSDUP 3C .Os .Sh NAME .Nm wcsdup .Nd duplicate wide-character string .Sh SYNOPSIS n wchar.h . .Ft wchar_t .Fo wcsdup .Fa "const wchar_t *string" .Fc . .Sh DESCRIPTION The .Fn wcsdup function duplicates a wide-character .Fa string , allocating sufficient memory to store the copy, and then copying from .Fa string . The resulting copy is returned. It may be deallocated with .Xr free 3C when it is no longer needed. The .Fn wcsdup function is the wide-character equivalent of .Xr strdup 3C . .Sh RETURN VALUES On success, the function .Fn wcsdup returns the newly allocated copy of the string; on failure it returns .Dv NULL and sets .Va errno . .Sh ERRORS The .Fn wcsdup function will fail if: l -tag -width Er t Er ENOMEM Insufficient memory was available to create the copy. .El .Sh INTERFACE STABILITY .Sy Standard . .Sh MT-LEVEL .Sy MT-Safe . .Sh SEE ALSO .Xr free 3C , .Xr strdup 3C , .Xr wcslen 3C , .Xr wchar.h 3HEAD , .Xr locale 5 , .Xr standards 5 .Sh STANDARDS The .Fn wcsdup function was introduced in .St -p1003.1-2008 .