NAME

strxfrm − string transformation

SYNTAX

strxfrm (to, from, maxsize)
char *to;
char *from;
int maxsize;

DESCRIPTION

The strxfrm function transforms the string pointed to by from and places the resulting string into the array pointed to by to.  The transformation is such that two transformed strings can be ordered by the strcmp function as appropriate to the program’s locale category LC_COLLATE.

The length of the resulting string may be much longer than the original.  No more than maxsize characters are placed into the resulting string including the terminator.  If the transformed string does not exceed maxsize characters, the number of characters (less the terminator) is returned. Otherwise the number of characters (less the terminator) in the transformed string is returned and the contents of the array are undefined.

SEE ALSO

string(3), setlocale(3int), strcoll(3int)

Subroutines