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.Return Values
Upon successful completion, strxfrm returns the length of the transformed string not including the terminating null character. If this value is \c n or more, the contents of \c dst are indeterminate.Last Modified: 18 Dec 11 @ 15:03 Page Rendered: 2022-03-14 17:36:36