strxfrm [ HP C/iX Library Reference Manual ] MPE/iX 5.0 Documentation
HP C/iX Library Reference Manual
strxfrm
Transforms a string in a manner appropriate for the current locale.
Syntax
#include <string.h>
size_t strxfrm(char *s1, const char *s2,
size_t n);
Parameters
s1 A string pointer to the destination string.
s2 A string pointer to a null-terminated source string.
n The maximum number of characters to transform, including
the terminating null character.
Return Values
x The length of the transformed string, not including the
terminating null character. If the value returned is
greater than or equal to n, the contents of the array
referenced by s1 are undefined.
Description
The transformation is such that the strcmp function can be used to
compare two transformed strings, giving the same result as strcoll
applied to the original strings.
No more than n characters are placed into the resulting array pointed to
by s1 (including the terminating null character). If copying takes place
between overlapping objects, the behavior is undefined.
See Also
memcmp(), strcmp(), strcoll(), ANSI C 4.11.4.5
MPE/iX 5.0 Documentation