strxfrm_l3
Transform a string under locale
Part of strxfrm(3).
Usage
#include <string.h>
size_t
strxfrm(char * restrict dst, const char * restrict src, size_t n);
size_t
strxfrm_l(char * restrict dst, const char *restrict src, size_t n, locale_t loc);
Library
Standard C Library (libc, -lc)
Overview
The strxfrm() function transforms a null-terminated string pointed to by src 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().
strxfrm_l() does the same, however takes an explicit locale rather than the global locale.
Return values
Upon successful completion, strxfrm() and strxfrm_l() return the length of the transformed string not including the terminating null character. If this value is n or more, the contents of dst are indeterminate.
Releases
33 releases since FreeBSD 9.1-RELEASE; the text changed 20 times.