HP 3000 Manuals

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