Transform one wide-character string into another, to a given length
#include <wchar.h> size_t wcsxfrm( wchar_t * ws1, const wchar_t * ws2, size_t n );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The wcsxfrm() function transforms the string pointed to by ws2 to the buffer pointed to by ws1, to a maximum of n wide-characters, including the terminating null. The two strings shouldn't overlap.
A call to wcscmp() returns the same result for two strings transformed by wcsxfrm() as wcscoll() would return for the original versions of the strings.
The length of the transformed wide-character string. If this value is greater than n, the contents of ws1 are indeterminate.
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |