-> Click here to learn how to get live help <-
NAMEstrxfrm - string transformation
#include <string.h> size_t strxfrm(char *dest, const char *src, size_t n);
DESCRIPTIONThe fBstrxfrm()fP function transforms the fIsrcfP string into a form such that the result of fBstrcmp()fP on two strings that have been transformed with fBstrxfrm()fP is the same as the result of fBstrcoll()fP on the two strings before their transformation. The first fInfP characters of the transformed string are placed in fIdestfP. The transformation is based on the program's current locale for category fILC_COLLATEfP. (See fBsetlocalefP(3)).
RETURN VALUEThe fBstrxfrm()fP function returns the number of bytes required to store the transformed string in fIdestfP excluding the terminating ` ' character. If the value returned is fInfP or more, the contents of fIdestfP are indeterminate.
CONFORMING TOSVID 3, BSD 4.3, ISO 9899
NOTESIn the fI"POSIX"fP or fI"C"fP locales fBstrxfrm()fP is equivalent to copying the string with fBstrncpy()fP.
SEE ALSObcmp(3), memcmp(3), strcasecmp(3), strcmp(3), strcoll(3), setlocale(3)