strxfrm
Transform a string under locale
Interface
#include <string.h>
size_t | strxfrm (char * restrict dst, const char * restrict src, size_t n) |
#include <xlocale.h>
size_t | strxfrm_l (char * restrict dst, const char * restrict src, size_t n, locale_t loc) |
Description
The strxfrm function transforms a null-terminated string pointed to bysrc
according to the current locale collation if any, then copies the transformed string into dst
. Not more than n
characters are copied into dst
, including the terminating null 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 strcmp after strxfrm is equal to comparing two original strings with strcoll.
While the strxfrm function uses the current locale, the strxfrm_l function may be passed a locale directly. See xlocale for more information.