strxfrm(3)                 Library Functions Manual                 strxfrm(3)

NAME
       strxfrm - string transform

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <string.h>

       size_t strxfrm(size_t size;
                      char dest[restrict size], const char src[restrict size],
                      size_t size);

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 size 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 size 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
       setlocale(3), strcmp(3), strcoll(3), string(3)

Linux man-pages 6.19              2026-08-10                        strxfrm(3)