home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | NOTES | SEE ALSO | COLOPHONThe Linux Programming Interface


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

NAME         top

       strxfrm - string transformation

SYNOPSIS         top

       #include <string.h>

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

DESCRIPTION         top

       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 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         top

       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         top

       SVr4, 4.3BSD, C89, C99.

NOTES         top

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

SEE ALSO         top

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

COLOPHON         top

       This page is part of release 3.32 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/.

GNU                                   2010-09-20                           STRXFRM(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable
counter