wcsdup(3) [netbsd man page]

WCSDUP(3)						   BSD Library Functions Manual 						 WCSDUP(3)

NAME

     wcsdup -- save a copy of a string

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <wchar.h>

     wchar_t *
     wcsdup(const wchar_t *str);

DESCRIPTION

     The wcsdup() function allocates sufficient memory for a copy of the wide-character string str, does the copy, and returns a pointer to it.
     The pointer may subsequently be used as an argument to the function free(3).

     If insufficient memory is available, NULL is returned.

EXAMPLES

     The following will point p to an allocated area of memory containing the nul-terminated string "foobar":

	   wchar_t *p;

	   if (p = wcsdup(L"foobar"), p == NULL) {
		   fprintf(stderr, "Out of memory.
");
		   exit(1);
	   }

ERRORS

     The wcsdup() function may fail and set the external variable errno for any of the errors specified for the library function malloc(3).

SEE ALSO

     free(3), malloc(3), strdup(3)

HISTORY

     The wcsdup() function first appeared in NetBSD 4.0.

BSD
								  August 25, 2006							       BSD

WCSDUP(3)						     Linux Programmer's Manual							 WCSDUP(3)

NAME

       wcsdup - duplicate a wide-character string

SYNOPSIS

       #include <wchar.h>

       wchar_t *wcsdup(const wchar_t *s);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       wcsdup():
	   Since glibc 2.10:
	       _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
	   Before glibc 2.10:
	       _GNU_SOURCE

DESCRIPTION

       The  wcsdup()  function	is  the wide-character equivalent of the strdup(3) function.  It allocates and returns a new wide-character string
       whose initial contents is a duplicate of the wide-character string pointed to by s.

       Memory for the new wide-character string is obtained with malloc(3), and should be freed with free(3).

RETURN VALUE

       The wcsdup() function returns a pointer to the new wide-character string, or NULL if sufficient memory was not available.

ERRORS

       ENOMEM Insufficient memory available to allocate duplicate string.

CONFORMING TO

       POSIX.1-2008.  This function is not specified in POSIX.1-2001, and is not widely available on other systems.

SEE ALSO

       strdup(3), wcscpy(3)

COLOPHON

       This page is part of release 3.44 of the Linux man-pages project.  A description of the project, and information about reporting bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

GNU
								    2010-09-15								 WCSDUP(3)