unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

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



NAME
       wcsncpy - copy a fixed-size string of wide characters

SYNOPSIS
       #include <&lt;wchar.h>&gt;

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

DESCRIPTION
       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 char-
       acters  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 char-
       acters at dest.

RETURN VALUE
       wcsncpy() returns dest.

CONFORMING TO
       C99.

SEE ALSO
       strncpy(3)

COLOPHON
       This  page  is  part of release 3.05 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)