wcsncpy()
QNX SDP8.0C Library ReferenceAPIDeveloper
Copy a wide-character string, to a maximum length
Synopsis:
#include <wchar.h>
wchar_t * wcsncpy( wchar_t * ws1,
const wchar_t * ws2,
size_t n );
Arguments:
- ws1
- A pointer to where you want to copy the wide-character string.
- ws2
- The wide-character string that you want to copy.
- n
- The maximum number of wide characters that you want to copy.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The wcsncpy() function copies the string pointed to by ws2, including the terminating NUL wide character, into the array pointed to by ws1, to a maximum of n wide characters. It adds NUL characters if ws2 has fewer than n characters but doesn't add a NUL if ws2 has more.
Note:
This function isn't guaranteed to work properly for copying overlapping
strings; use
wmemmove()
instead.
Returns:
The same pointer as ws1.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: