Name
wcsncpy — copy a fixed-size string of wide
characters
Synopsis
#include <wchar.h>
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 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
wcsncpy() returns dest.
SEE ALSO
strncpy(3)
Copyright (c) Bruno Haible <haible@clisp.cons.org>
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
References consulted:
GNU glibc-2 source code and manual
Dinkumware C library reference http://www.dinkumware.com/
OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
ISO/IEC 9899:1999
|
