strxfrm

NAME

strxfrm - string transformation

SYNOPSIS

#include <string.h>
 I size_t strxfrm(char * dest , const char * src , size_t  n );

DESCRIPTION

The R strxfrm () function transforms the src string into a form such that the result of strcmp(3) on two strings that have been transformed with R 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

The R 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

SVr4, 4.3BSD, C89, C99

NOTES

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

SEE ALSO

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