NAME

       strxfrm - string transformation

SYNOPSIS

       #include <string.h>

       size_t strxfrm(char *dest, const char *src, size_t n);

DESCRIPTION

       The  strxfrm()  function  transforms  the  src  string into a form such that the result of
       strcmp(3) on two strings that have been transformed with strxfrm()  is  the  same  as  the
       result of strcoll(3) on the two strings before their transformation.  The first n bytes of
       the transformed string are placed in dest.  The transformation is based on  the  program's
       current locale for category LC_COLLATE.  (See setlocale(3)).

RETURN VALUE

       The  strxfrm()  function  returns  the  number  of bytes required to store the transformed
       string in dest excluding the terminating null byte ('\0').  If the value returned is n  or
       more, the contents of dest are indeterminate.

CONFORMING TO

       SVr4, 4.3BSD, C89, C99.

NOTES

       In the POSIX or C locales strxfrm() is equivalent to copying the string with strncpy(3).

SEE ALSO

       bcmp(3), memcmp(3), setlocale(3), strcasecmp(3), strcmp(3), strcoll(3), string(3)

COLOPHON

       This  page  is  part of release 3.54 of the Linux man-pages project.  A description of the
       project,    and    information    about    reporting    bugs,    can    be    found     at
       http://www.kernel.org/doc/man-pages/.