NAME
wcsxfrm, wcsxfrm_l
— transform a wide string under
locale
SYNOPSIS
#include
<wchar.h>
size_t
wcsxfrm(wchar_t
*dst, const wchar_t
*src, size_t
n);
size_t
wcsxfrm_l(wchar_t
*dst, const wchar_t
*src, size_t n,
locale_t locale);
DESCRIPTION
The idea of
wcsxfrm()
and
wcsxfrm_l()
is to “un-localize” a wide string: the functions transform
src, storing the result in dst,
such that wcscmp(3) on transformed wide strings returns what
wcscoll(3) on the original untransformed wide strings would
return.
On OpenBSD, both have the same effect as wcslcpy(3), and the global locale, the thread-specific locale, and the locale argument are ignored.
ENVIRONMENT
On other operating systems, the behaviour of
wcsxfrm() may depend on the
LC_CTYPE
locale(1).
SEE ALSO
newlocale(3), setlocale(3), wcscmp(3), wcscoll(3), wcslcpy(3)
STANDARDS
The wcsxfrm() function conforms to
ISO/IEC 9899:1999 (“ISO C99”),
and wcsxfrm_l() to IEEE Std
1003.1-2008 (“POSIX.1”).
HISTORY
The wcsxfrm() function has been available
since OpenBSD 4.8, and
wcsxfrm_l() since OpenBSD
6.2.