NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | SEE ALSO | COLOPHON

The Linux Programming Interface

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

NAME         top

       wcsncpy - copy a fixed-size string of wide characters

SYNOPSIS         top

       #include <wchar.h>

       wchar_t *wcsncpy(wchar_t *dest, const wchar_t *src, size_t n);

DESCRIPTION         top

       The wcsncpy() function is the wide-character equivalent of the strncpy(3)
       function.  It copies at most n wide characters from the wide-character string
       pointed to by src, including the terminating L'\0' character, to the array
       pointed to by dest.  Exactly n wide characters are written at dest.  If the
       length wcslen(src) is smaller than n, the remaining wide characters in the
       array pointed to by dest are filled with L'\0' characters.  If the length
       wcslen(src) is greater or equal to n, the string pointed to by dest will not
       be L'\0' terminated.

       The strings may not overlap.

       The programmer must ensure that there is room for at least n wide characters
       at dest.

RETURN VALUE         top

       wcsncpy() returns dest.

CONFORMING TO         top

       C99.

SEE ALSO         top

       strncpy(3)

COLOPHON         top

       This page is part of release 3.32 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                                   1999-07-25                           WCSNCPY(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface