STRXFRM(3) Linux Programmer's Manual STRXFRM(3)
NAME
strxfrm - string transformation
SYNOPSIS
#include<string.h>
size_tstrxfrm(char*dest,constchar*src,size_t n);
DESCRIPTION
The strxfrm() function transforms the src string into a form such that
the result of strcmp() on two strings that have been transformed with
strxfrm() is the same as the result of strcoll() on the two strings
before their transformation. The first n characters of the transformed
string are placed in dest. The transformation is based on the pro-
gram's current locale for category LC_COLLATE. (See setlocale(3)).
RETURNVALUE
The strxfrm() function returns the number of bytes required to store
the transformed string in dest excluding the terminating '\0' charac-
ter. If the value returned is n or more, the contents of dest are
indeterminate.
CONFORMINGTO
SVID 3, BSD 4.3, ISO 9899
NOTES
In the "POSIX" or "C" locales strxfrm() is equivalent to copying the
string with strncpy().
SEEALSO
bcmp(3), memcmp(3), strcasecmp(3), strcmp(3), strcoll(3), setlocale(3)
GNU 1993-04-12 STRXFRM(3)