WCSDUP(3) | Library Functions Manual | WCSDUP(3)

# 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.

August 25, 2006 | NetBSD 7.2