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() 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  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 `\0' character.  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 with strncpy().

SEE ALSO

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

GNU                                              April 12, 1993                                       STRXFRM(3)