Changes a wide-character string such that the changed string can
    be passed to the wcscmp function and produce the same result as
    passing the unchanged string to the wcscoll function.

    Format

      #include  <wchar.h>

      size_t wcsxfrm  (wchar_t *ws1, const wchar_t *ws2, size_t
                      maxchar);