STRXFRM(3) Linux Programmer's Manual STRXFRM(3)
NAME
strxfrm - string(3,n) transformation
SYNOPSIS
#include <string.h>
size_t strxfrm(char *dest, const char *src, size_t n);
DESCRIPTION
The strxfrm() function transforms the src string(3,n) 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(3,n) are placed in(1,8) dest. The transformation is based on the pro-
gram's current locale(3,5,7) for category LC_COLLATE. (See setlocale(3)).
RETURN VALUE
The strxfrm() function returns the number of bytes required to store
the transformed string(3,n) in(1,8) dest excluding the terminating `\0' charac-
ter. If the value returned is n or more, the contents of dest are
indeterminate.
CONFORMING TO
SVID 3, BSD 4.3, ISO 9899
NOTES
In the "POSIX" or "C" locales strxfrm() is equivalent to copying the
string(3,n) with strncpy().
SEE ALSO
bcmp(3), memcmp(3), setlocale(3), strcasecmp(3), strcmp(3), strcoll(3)
GNU 1993-04-12 STRXFRM(3)