f17
SYNOPSIS #include <string.h> size_t strxfrm(char *s1, const char *s2, size_t n);
DESCRIPTION
strxfrm
transforms the string pointed to by s2
and places the resulting string into the array pointed to by s1.
The transformation is such that if the strcmp
function is applied to the two transformed strings, it returns a value
greater than, equal to, or less than zero, corresponding to the result
of a strcoll
function applied to the same two original strings.
No more than n characters are placed into the resulting array pointed to by s1, including the terminating null character. If n is zero, s1 may be a null pointer. If copying takes place between objects that overlap, the behavior is undefined.
With a C locale, this function just copies.
RETURNS
The strxfrm
function returns the length of the transformed string (not including the
terminating null character). If the value returned is n
or more, the contents of the array pointed to by s1
are indeterminate.
COMPLIANCE
strxfrm
is ANSI C.
strxfrm requires no supporting OS subroutines.
0