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