WCSDUP(3)

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 9.0