The
strxfrm ();
function transforms a null-terminated string pointed to by
Fa src
according to the current locale collation if any,
then copies the transformed string
into
Fa dst .
Not more than
Fa n
characters are copied into
Fa dst ,
including the terminating null character added.
If
Fa n
is set to 0
(it helps to determine an actual size needed
for transformation),
Fa dst
is permitted to be a NULL pointer.
Comparing two strings using
strcmp ();
after
strxfrm ();
is equal to comparing
two original strings with
strcoll (.);
RETURN VALUES
Upon successful completion,
strxfrm ();
returns the length of the transformed string not including
the terminating null character.
If this value is
Fa n
or more, the contents of
Fa dst
are indeterminate.
