size_t
wcsxfrm(
wchar_t * restrict dst
, const wchar_t * restrict src
, size_t n
)
)
function transforms a nul-terminated wide character string pointed to by
src
according to the current locale collation order then copies the
transformed string into
dst
.
No more than
n
wide characters are copied into
dst
,
including the terminating nul character added.
If
n
is set to 0
(it helps to determine an actual size needed for transformation),
dst
is permitted to be a null pointer.
Comparing two strings using
wcscmp()
after
wcsxfrm(
)
is equivalent to comparing two original strings with
wcscoll(
).
)
returns the length of the transformed string not including
the terminating nul character.
If this value is
n
or more, the contents of
dst
are indeterminate.
)
function conforms to
ISO/IEC 9899:1999 (``ISO C99'') .
)
function disregards
LC_COLLATE
locales, and falls back to using the
wcsncpy(
)
function.