WCSXFRM(3) | Library Functions Manual | WCSXFRM(3) |
wcsxfrm
—
#include <wchar.h>
size_t
wcsxfrm
(wchar_t
* restrict dst, const
wchar_t * restrict src,
size_t n);
wcsxfrm
() 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
().
wcsxfrm
() 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.
wcsxfrm
() function conforms to
ISO/IEC 9899:1999 (“ISO C99”).
wcsxfrm
() function
disregards LC_COLLATE
locales, and falls back to using
the wcsncpy
() function.
October 13, 2006 | NetBSD 9.0 |