6.28 wcsxfrm—locale-specific wide-character string transformation

Synopsis

     #include <wchar.h>
     int wcsxfrm(wchar_t *__restrict stra,
         const wchar_t *__restrict strb, size_t n);
     

Description
wcsxfrm transforms the wide-character string pointed to by strb to the wide-character string pointed to by stra, Comparing two transformed wide strings with wcscmp should return the same result as comparing the original strings with wcscoll. No more than n wide characters are transformed, including the trailing null character.

If n is 0, stra may be a NULL pointer.

The current implementation of wcsxfrm simply uses wcslcpy and does not support any language-specific transformations.