dwww Home | Manual pages | Find package

wcsdup(3)                  Library Functions Manual                  wcsdup(3)

NAME
       wcsdup - duplicate a wide-character string

LIBRARY
       Standard C library (libc, -lc)

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:
               _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
       On  success,  wcsdup()  returns  a  pointer  to  the new wide-character
       string.  On error, it returns NULL, with errno set to indicate the  er-
       ror.

ERRORS
       ENOMEM Insufficient memory available to allocate duplicate string.

ATTRIBUTES
       For  an  explanation  of  the  terms  used  in  this  section,  see at-
       tributes(7).

       ┌────────────────────────────────────────────┬───────────────┬─────────┐
       │InterfaceAttributeValue   │
       ├────────────────────────────────────────────┼───────────────┼─────────┤
       │wcsdup()                                    │ Thread safety │ MT-Safe │
       └────────────────────────────────────────────┴───────────────┴─────────┘

STANDARDS
       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)

Linux man-pages 6.03              2022-12-15                         wcsdup(3)

Generated by dwww version 1.15 on Mon Jun 24 13:26:55 CEST 2024.