STRXFRM(M)          Linux Programmer's Manual          STRXFRM(M)



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 trans-
       formation.   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(e)).

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(p), memcmp(p), strcasecmp(p), strcmp(p),  strcoll(l),
       setlocale(e)



GNU                         1993-04-12                 STRXFRM(M)