wcscxfrm()

Transform two wide-character strings

Synopsis:

#include <wchar.h>

int wcscfrm( wchar_t * ws1,
             const wchar_t * ws2,
             size_t n );

Library:

libc

Description:

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.

This function doesn't report errors in its returns; set errno to 0, call wcsxfrm() then check errno again.

Returns:

x

The length of the transformed wide-character string. If x > n, the contents of ws1 are indeterminate.

Classification:

ANSI

wcscxfrm()

See also:

setlocale()

"String manipulation functions" and "Wide-character functions" in the summary of functions chapter.