strxfrm(3)                 Library Functions Manual                 strxfrm(3)

NAME
       strxfrm - string transformation

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <string.h>

       size_t strxfrm(char dest[restrict .n], const char src[restrict .n],
                      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.

ATTRIBUTES
       For an explanation of the terms used in this section, see
       attributes(7).

       +-------------------------------------+---------------+----------------+
       |Interface                            | Attribute     | Value          |
       +-------------------------------------+---------------+----------------+
       |strxfrm ()                           | Thread safety | MT-Safe locale |
       +-------------------------------------+---------------+----------------+
STANDARDS
       C11, POSIX.1-2008.

HISTORY
       POSIX.1-2001, C89, SVr4, 4.3BSD.

SEE ALSO
       memcmp(3), setlocale(3), strcasecmp(3), strcmp(3), strcoll(3),
       string(3)

Linux man-pages 6.7               2023-10-31                        strxfrm(3)