HP C/iX Library Reference Manual (30026-90004)

Chapter 5 357
HP C/iX Library Function Descriptions
strxfrm
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