NAME

wcsdup — save a copy of a wide 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.\n"); 
	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.